Skip to main content
У цьому документі буде представлено інструкцію з інтеграції Hailuo Videos Generation API, яка дозволяє генерувати офіційні відео Hailuo за допомогою введення користувацьких параметрів.

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

Щоб використовувати Hailuo Videos Generation API, спочатку перейдіть до консолі Ace Data Cloud, щоб отримати ваш API Token, зберігши його для подальшого використання. Якщо ви ще не увійшли в систему або не зареєстровані, вас автоматично перенаправлять на сторінку входу, щоб запросити реєстрацію та вхід, після чого ви будете автоматично повернені на цю сторінку. Один API Token дозволяє викликати всі послуги платформи, не потрібно окремо подавати заявку на кожну послугу. Перший запит на отримання токена надає безкоштовний ліміт, щоб ви могли безкоштовно протестувати; якщо ліміт вичерпано, ви можете поповнити загальний баланс в консолі.
📘 Повна документація: Hailuo Videos Generation API →

​
Основне використання

Спочатку розглянемо основний спосіб використання, а саме введення підказки prompt, дії action, URL першого зображення first_image_url та моделі model, щоб отримати оброблений результат. Спочатку потрібно просто передати поле action, значення якого буде generate, потім потрібно ввести модель, наразі основними є модель для генерації відео з зображення minimax-i2v та модель для генерації відео з тексту minimax-t2v, деталі наведені нижче:

Ми бачимо, що тут налаштовані заголовки запиту, включаючи:
  • accept: формат відповіді, який ви хочете отримати, тут вказано application/json, тобто формат JSON.
  • authorization: ключ для виклику API, після подачі заявки ви можете вибрати його зі списку.
Також налаштовано тіло запиту, яке включає:
  • model: модель для генерації відео, основні з яких - модель для генерації відео з зображення minimax-i2v та модель для генерації відео з тексту minimax-t2v.
  • action: дія для цього завдання з генерації відео.
  • first_image_url: URL першого зображення, яке потрібно завантажити, якщо вибрана модель для генерації відео з зображення minimax-i2v, не підтримується кодування Base64.
  • prompt: підказка.
  • callback_url: URL для отримання результатів.
  • async: необов’язковий, якщо встановити в true, інтерфейс негайно поверне task_id, не потрібно надавати callback_url, потім через відповідний інтерфейс запиту завдань можна опитувати результати.
Після вибору ви можете помітити, що праворуч також згенеровано відповідний код, як показано на малюнку:

Натисніть кнопку «Спробувати», щоб провести тестування, як показано на малюнку, ми отримали наступний результат:
У повернутому результаті є кілька полів, описаних нижче:
  • success: статус завдання з генерації відео.
  • task_id: ID завдання з генерації відео.
  • trace_id: ID відстеження генерації відео.
  • data: список результатів завдання з генерації відео.
    • id: ID відео, згенерованого в рамках завдання.
    • prompt: підказка для завдання з генерації відео.
    • model: посилання на обкладинку завдання з генерації відео.
    • video_url: посилання на згенероване відео.
    • state: статус завдання з генерації відео.
Ми отримали задовільну інформацію про відео, нам потрібно лише отримати згенероване відео Hailuo за адресою посилання на відео в data. Крім того, якщо ви хочете згенерувати відповідний код інтеграції, ви можете просто скопіювати його, наприклад, код CURL виглядає так:

​
Асинхронний зворотний виклик

Оскільки час генерації Hailuo Videos Generation API відносно тривалий, приблизно 1-2 хвилини, якщо API довго не відповідає, HTTP запит буде підтримувати з’єднання, що призведе до додаткових витрат системних ресурсів, тому цей API також підтримує асинхронний зворотний виклик. Загальний процес: коли клієнт ініціює запит, додатково вказується поле callback_url, після ініціювання запиту API негайно поверне результат, що містить інформацію про поле task_id, яке представляє ID поточного завдання. Коли завдання завершено, результати генерації відео будуть надіслані на вказаний клієнтом callback_url у форматі POST JSON, в якому також буде включено поле task_id, таким чином результати завдання можна буде пов’язати за ID. Далі ми розглянемо приклад, щоб зрозуміти, як це працює. По-перше, зворотний виклик Webhook - це служба, яка може приймати HTTP запити, розробники повинні замінити на URL свого HTTP сервера. Для зручності демонстрації використовується публічний веб-сайт з прикладом Webhook https://webhook.site/, відкривши цей сайт, ви отримаєте URL Webhook, як показано на малюнку: Скопіюйте цей URL, і ви зможете використовувати його як Webhook, приклад тут: https://webhook.site/580b81f5-596e-4321-b03f-606770b0bb83. Далі ми можемо налаштувати поле callback_url на вказаний Webhook URL, одночасно заповнивши відповідні параметри, деталі наведені на малюнку:

Натиснувши «Запустити», ви отримаєте результат, як показано нижче:
Через деякий час ви зможете спостерігати результати генерації відео на https://webhook.site/580b81f5-596e-4321-b03f-606770b0bb83, як показано на малюнку: Зміст такий:
Можна побачити, що в результаті є поле task_id, інші поля схожі на попередні, через це поле можна реалізувати зв’язок завдань.

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

При виклику API, якщо виникає помилка, API поверне відповідний код помилки та інформацію. Наприклад:
  • 400 token_mismatched: Неправильний запит, можливо, через відсутні або недійсні параметри.
  • 400 api_not_implemented: Неправильний запит, можливо, через відсутні або недійсні параметри.
  • 401 invalid_token: Неавторизовано, недійсний або відсутній токен авторизації.
  • 429 too_many_requests: Занадто багато запитів, ви перевищили ліміт запитів.
  • 500 api_error: Внутрішня помилка сервера, щось пішло не так на сервері.

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

​
Висновок

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