Выбирайте режим «изображение в видео», если первый кадр является частью задания. Выбирайте преобразование текста в видео, если источником является письменный текст. Проверьте соответствующую официальную справку по API, чтобы узнать, какие поля запроса поддерживаются при отправке приложением задачи.
Сначала выберите режим ввода.
OdiRouter Hailuo 02 image-to-video model page подходит для процесса, начинающегося с изображения. В его API reference описаны маршрут очереди minimax-hailuo-02-i2v и first_frame_image, который принимает публичный URL изображения или URL данных Base64.
OdiRouter Hailuo 02 text-to-video model page подходит для процесса, начинающегося с промпта. В его API reference описаны minimax-hailuo-02-t2v, а также поля промпта, длительности, разрешения, оптимизации промпта, предварительной обработки и водяного знака.
В документации описаны различные сочетания длительности и разрешения. Проверяйте запрошенную пользователем пару значений, вместо того чтобы предполагать, что все варианты длительности доступны при любом разрешении.
Отправьте задачу и сохраните её идентификатор.
В обеих справках описан процесс на основе очереди. Создайте задачу с помощью POST, сохраните request_id, проверьте документированный маршрут статуса с помощью GET, затем получите готовый результат по маршруту ответа. Используйте маршрут отмены только в случаях, когда приложению необходимо остановить ожидающую задачу.
Документированный базовый URL API модели: https://api.odirouter.ai/model. Маршрут создания задачи «текст в видео»: POST /v1/queue/minimax-hailuo-02-t2v. Маршрут создания задачи «изображение в видео»: POST /v1/queue/minimax-hailuo-02-i2v.
Форма запроса на преобразование текста в видео
curl --location "https://api.odirouter.ai/model/v1/queue/minimax-hailuo-02-t2v" \
--header "Authorization: Bearer YOUR_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"prompt": "A paper boat floats across a rain-slick street at night, slow camera pan.",
"duration": 6,
"resolution": "768P"
}'Храните ключ в защищённом хранилище секретов на стороне сервера. Не раскрывайте его в коде браузера и не добавляйте в репозиторий. Сохраните request_id вместе с записью задания приложения, чтобы повторные попытки, проверки состояния и обработка результатов были привязаны к одной и той же задаче.
Структура запроса «изображение в видео»
curl --location "https://api.odirouter.ai/model/v1/queue/minimax-hailuo-02-i2v" \
--header "Authorization: Bearer YOUR_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"first_frame_image": "https://example.com/reference-image.webp",
"prompt": "A red paper lantern sways gently in an evening breeze, locked camera.",
"duration": 6,
"resolution": "768P"
}'Прежде чем принимать изображение от пользователя, проверьте актуальные ограничения по формату, размеру и разрешению/длительности в связанной справке по режиму «изображение в видео».
Следующий шаг
Для процесса с первым кадром откройте OdiRouter Hailuo 02 image-to-video documentation. Для процесса, начинающегося с промпта, откройте OdiRouter Hailuo 02 text-to-video documentation. Ознакомьтесь с актуальной справкой, прежде чем переводить прототип в производственную среду.