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, ссылки на первое изображение 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: ссылка на первое изображение, которое необходимо загрузить при выборе модели для генерации видео из изображений 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, API немедленно возвращает результат, содержащий информацию о поле task_id, представляющем текущий ID задачи. Когда задача завершена, результат сгенерированного видео будет отправлен на указанный клиентом callback_url в формате POST JSON, который также включает поле task_id, что позволяет связать результаты задачи по ID. Давайте рассмотрим конкретные действия на примере. Во-первых, Webhook обратный вызов — это служба, которая может принимать HTTP-запросы, разработчики должны заменить его на URL своего HTTP-сервера. Для удобства демонстрации используется публичный сайт примера Webhook https://webhook.site/, открыв который, вы получите Webhook URL, как показано на изображении: Скопируйте этот 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. Если у вас есть какие-либо вопросы, пожалуйста, не стесняйтесь обращаться в нашу техническую поддержку.