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, спочатку перейдіть до консолі Ace Data Cloud для отримання вашого API Token, зберігайте його на випадок потреби. Якщо ви ще не увійшли в систему або не зареєстровані, вас автоматично перенаправлять на сторінку входу, щоб запросити реєстрацію та вхід, після чого ви будете автоматично повернені на цю сторінку. Один 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 є масивом деталей пакетних завдань (кожен елемент має такий же формат, як і результат запиту одного).

​
Обробка помилок

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

​
Приклад помилки відповіді

​
Висновок

Завдяки цьому документу ви дізналися, як використовувати Dreamina Tasks API для запиту результатів окремих або пакетних завдань з відео цифрових людей. У поєднанні з callback_url / async асинхронним режимом інтерфейсу генерації, ви можете реалізувати стабільне опитування. Якщо у вас є будь-які питання, будь ласка, звертайтеся до нашої команди технічної підтримки.