Семейство Hailuo (MiniMax)

Модели генерации видео Hailuo от MiniMax — всего две, вызываются через видеоэндпоинт OfoxAI POST /v1/videos. Задачи выполняются асинхронно: после создания задачи вы получаете её ID и по нему запрашиваете результат.

Выбор модели

Обе модели поддерживают текст в видео, изображение в видео и видеореференсы, а также могут создавать синхронную звуковую дорожку (generate_audio по умолчанию true). adaptive означает сохранение пропорций входного изображения.

Таблица выше совпадает с video_attributes, которые возвращает Models API; если возможности модели изменятся, ориентируйтесь на ответ API. Оплата посекундная, фактическая стоимость определяется полем usage.video_cost в результате задачи; цены см. на странице модели .

Примеры вызова

Примеры ниже показывают только запрос на создание задачи. Полный процесс — запрос статуса и скачивание результата — описан в разделе Video API · Быстрый старт.

curl -X POST https://api.ofox.ai/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"
  }'

curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/hailuo-3",
    "prompt": "Человек в кадре разворачивается и уходит вдаль",
    "duration": 5,
    "frame_images": [
      { "type": "image_url", "image_url": { "url": "https://example.com/first.jpg" }, "frame_type": "first_frame" }
    ]
  }'

curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/hailuo-3",
    "prompt": "Сохранить движение камеры и перевести изображение в стиль анимации тушью",
    "duration": 5,
    "input_references": [
      { "type": "video_url", "video_url": { "url": "https://example.com/source.mp4" } }
    ]
  }'

• frame_images и input_references нельзя передавать одновременно — это возвращает 400 references_conflict.
• Если звуковая дорожка не нужна, передайте "generate_audio": false.
• Полное описание структуры полей — в разделе Создание задачи видео.

Значения разрешения

Уровни разрешения у Hailuo отличаются от других семейств: 768p и 2k (строчная k). Привычные для других семейств 720p и 1080p вернут 400.

Распространённые ошибки

Полный список кодов — в разделе Коды ошибок Video API.

Официальная документация

• Документация открытой платформы MiniMax 
• OfoxAI · Создание задачи видео

Часто задаваемые вопросы