Семейство Hailuo (MiniMax)
Модели генерации видео Hailuo от MiniMax — всего две, вызываются через видеоэндпоинт OfoxAI POST /v1/videos. Задачи выполняются асинхронно: после создания задачи вы получаете её ID и по нему запрашиваете результат.
Выбор модели
Обе модели поддерживают текст в видео, изображение в видео и видеореференсы, а также могут создавать синхронную звуковую дорожку (generate_audio по умолчанию true). adaptive означает сохранение пропорций входного изображения.
minimax/hailuo-3768p, 2Kminimax/hailuo-3-max480p, 768p, минимум 5 секундТаблица выше совпадает с video_attributes, которые возвращает Models API; если возможности модели изменятся, ориентируйтесь на ответ API. Оплата посекундная, фактическая стоимость определяется полем usage.video_cost в результате задачи; цены см. на странице модели .
Примеры вызова
Примеры ниже показывают только запрос на создание задачи. Полный процесс — запрос статуса и скачивание результата — описан в разделе Video API · Быстрый старт.
Текст в видео
Передаётся только prompt.
curl -X POST https://api.ofox.io/v1/videos \
-H "Authorization: Bearer $OFOX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax/hailuo-3",
"prompt": "Широкоэкранный кадр: ретроавтомобиль едет по пустынному шоссе навстречу закату",
"duration": 6,
"resolution": "768p",
"aspect_ratio": "21:9"
}'frame_imagesиinput_referencesнельзя передавать одновременно — это возвращает400 references_conflict.- Если звуковая дорожка не нужна, передайте
"generate_audio": false. - Полное описание структуры полей — в разделе Создание задачи видео.
Значения разрешения
Уровни разрешения у Hailuo отличаются от других семейств: 768p и 2k (строчная k). Привычные для других семейств 720p и 1080p вернут 400.
Распространённые ошибки
Полный список кодов — в разделе Коды ошибок Video API.
Официальная документация
Часто задаваемые вопросы
Поддерживает ли Hailuo 3 разрешение 1080p?
Нет. Hailuo 3 поддерживает 768p и 2k, Hailuo 3 Max — 480p и 768p. Значения 720p и 1080p возвращают 400 resolution not supported.
Hailuo 3 Max возвращает ошибку duration 4 out of range [5, 15] — что делать?
Длительность одной задачи Hailuo 3 Max — от 5 до 15 секунд. Для видео длиной 4 секунды используйте Hailuo 3.
Поддерживает ли Hailuo соотношение 21:9?
Да. Hailuo 3 и Hailuo 3 Max поддерживают 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 и adaptive.