Skip to main content

​
Интеграция и использование Dreamina Tasks API

Dreamina Tasks API используется для запроса результатов выполнения задач по созданию видео с цифровыми людьми, созданных с помощью Dreamina Video Generation API. Когда вы передаете callback_url или async: true в интерфейсе генерации, интерфейс сразу возвращает task_id, и вы можете опрашивать статус задачи и конечный адрес видео через этот интерфейс по task_id или trace_id. Этот интерфейс бесплатный.

​
Процесс подачи заявки

Чтобы использовать API серии Dreamina, сначала получите ваш API Token в консоли Ace Data Cloud для резервного копирования. Если вы еще не вошли в систему или не зарегистрированы, вы будете автоматически перенаправлены на страницу входа, где вас пригласят зарегистрироваться и войти в систему, после чего вы будете автоматически возвращены на текущую страницу. Один API Token позволяет вызывать все сервисы платформы, не нужно подавать отдельные заявки на каждый сервис. При первой подаче заявки предоставляется бесплатный лимит, чтобы вы могли попробовать; если лимит исчерпан, вы можете пополнить общий баланс в консоли.

​
Параметры запроса

Request Headers
  • accept：укажите, что хотите получить ответ в формате JSON, заполните application/json.
  • authorization：ключ для вызова API, формат Bearer {token}.
  • content-type：заполните application/json.
Request Body
При запросе одной задачи необходимо предоставить хотя бы один из id или trace_id.

​
Запрос одной задачи

​
CURL

​
Python

​
Пример ответа

После успешного запроса API возвращает детали этой задачи. request — это тело запроса, созданного при создании задачи, response — это тело ответа после завершения задачи, где data.video_url является адресом сгенерированного видео с цифровым человеком:
Описание полей:
  • id：уникальный ID задачи по созданию видео.
  • trace_id：ID отслеживания данного запроса, используется для устранения проблем.
  • request：содержимое запроса, отправленного при создании задачи.
  • response：содержимое ответа, возвращаемое после завершения задачи. Когда response.data.status равно done, response.data.video_url является конечным адресом видео.
  • created_at：время создания задачи, Unix временная метка (секунды, с плавающей точкой).
  • started_at：время начала выполнения задачи, Unix временная метка (секунды, с плавающей точкой).
  • finished_at：время завершения задачи, Unix временная метка (секунды, с плавающей точкой). Поле не возвращается, если задача не завершена.
  • elapsed：время выполнения задачи, в секундах (с плавающей точкой, с 3 знаками после запятой). Поле не возвращается, если задача не завершена.
Если задача еще не завершена, status может быть не в состоянии done; если задача не существует или результат еще не сгенерирован, интерфейс вернет пустой объект {}, пожалуйста, попробуйте позже.

​
Пакетный запрос задач

Установите action в retrieve_batch и передайте массив ids:
В возвращаемом результате items — это массив деталей пакетных задач (каждый элемент имеет такой же формат, как и результат одиночного запроса), count — количество задач, возвращенных в этот раз.

​
Обработка ошибок

При вызове API, если возникает ошибка, будет возвращен соответствующий код ошибки и информация:
  • 400 bad_request：ошибка запроса, возможно, отсутствуют необходимые параметры, такие как id / trace_id.
  • 401 invalid_token：неавторизован, токен авторизации недействителен или отсутствует.
  • 429 too_many_requests：слишком много запросов, превышен лимит скорости.
  • 500 api_error：внутренняя ошибка сервера.

​
Пример ответа об ошибке

​
Заключение

С помощью этого документа вы узнали, как использовать Dreamina Tasks API для запроса результатов одиночных или пакетных задач по созданию видео с цифровыми людьми. В сочетании с callback_url / async асинхронным режимом интерфейса генерации можно реализовать стабильное опрашивание. Если у вас есть какие-либо вопросы, пожалуйста, не стесняйтесь обращаться в нашу техническую поддержку.