Skip to main content
POST

Авторизация

string
обязательно
Все эндпоинты API требуют аутентификации по Bearer TokenПолучение API Key:Перейдите на страницу управления API Key, чтобы получить ваш API KeyДобавьте в заголовок запроса:

Параметры запроса

string
обязательно
Поддерживаемые модели:
  • MiniMax-Hailuo-2.3 — Hailuo 2.3
  • MiniMax-Hailuo-2.3-Fast — Hailuo 2.3 Fast (с пониженной задержкой)
MiniMax-Hailuo-2.3-Fast:
Для этой модели параметр first_frame_image обязателен.
boolean
по умолчанию:"false"
Выполнять ли проверку содержимого перед отправкой задачи генерации видео.
  • true: проверить промпты и входные изображения с помощью omni-moderation-latest
  • false или параметр не указан: не отправлять запрос на проверку, без дополнительных затрат и задержки (по умолчанию)
string
обязательно
Описание содержания видео (не более 2000 символов)Подробно опишите сцены, действия и стили для лучших результатов генерации. Поддерживаются команды управления камерой (см. раздел «Команды управления камерой» ниже).Пример: "A cute kitten running on the grass"
integer
по умолчанию:"6"
Длительность видео (секунды)Варианты:
  • 6 — видео длиной 6 секунд
  • 10 — видео длиной 10 секунд
По умолчанию: 6
Ограничение 1080p: при разрешении 1080p поддерживается только длительность 6 секунд
string
по умолчанию:"768p"
Разрешение видеоВарианты:
  • 768p — высокая чёткость
  • 1080p — Full HD (только длительность 6 секунд)
По умолчанию: 768p
string
Первый кадр видеоПоддерживается два формата:
  • Публичный URL: https://example.com/start.jpg
  • Base64-кодирование: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
При передаче это изображение будет использовано как начальный кадр видео
MiniMax-Hailuo-2.3-Fast:
Для этой модели параметр first_frame_image обязателен.
boolean
по умолчанию:"true"
Включить ли автоматическую оптимизацию промптаПри включении система автоматически оптимизирует ваш промпт для лучших результатов генерацииПо умолчанию: true
boolean
по умолчанию:"false"
Сокращать ли время оптимизации промптаПри включении скорость обработки выше, но качество оптимизации может слегка снизитьсяПо умолчанию: false
boolean
по умолчанию:"false"
Добавлять ли водяной знакПо умолчанию: false

Комбинации разрешения и длительности

Команды управления камерой

Используйте синтаксис [команда] в prompt для управления движениями камеры. Поддерживается 15 команд: Пример использования:

Ответ

integer
Код статуса ответа, 200 при успехе
array
Массив данных ответа

Сценарии использования

Сценарий 1: Быстрая генерация из текста

Сценарий 2: Высококачественное видео 1080p

Сценарий 3: Видео из изображения с заданным первым кадром

Сценарий 4: Команды управления камерой

Сценарий 5: Режим быстрой предобработки

Запрос результатов задачиГенерация видео — асинхронная задача, которая при отправке возвращает task_id. Используйте эндпоинт Получение статуса задачи для запроса прогресса и результатов генерации.