Генерация видео MiniMax Hailuo H3

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{"model":"MiniMax-H3","prompt":"Камера медленно приближается к астронавту на поверхности Луны","duration":5,"resolution":"2K","aspect_ratio":"16:9"}'

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax-H3",
    "prompt": "Сохранить персонажа из изображения 1, следовать движению камеры из видео 1 и использовать голос из аудио 1",
    "duration": 5,
    "resolution": "2K",
    "aspect_ratio": "adaptive",
    "image_with_roles": [{"url": "https://example.com/person.png", "role": "reference_image"}],
    "video_with_roles": [{"url": "https://example.com/motion.mp4", "role": "reference_video"}],
    "audio_with_roles": [{"url": "https://example.com/voice.mp3", "role": "reference_audio"}]
  }'

{"id":"vid_01KZ3H3EXAMPLE00000000000","object":"generation.task","model":"MiniMax-H3","status":"queued","progress":0,"created_at":1785729000}

POST

videos

generations

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{"model":"MiniMax-H3","prompt":"Камера медленно приближается к астронавту на поверхности Луны","duration":5,"resolution":"2K","aspect_ratio":"16:9"}'

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax-H3",
    "prompt": "Сохранить персонажа из изображения 1, следовать движению камеры из видео 1 и использовать голос из аудио 1",
    "duration": 5,
    "resolution": "2K",
    "aspect_ratio": "adaptive",
    "image_with_roles": [{"url": "https://example.com/person.png", "role": "reference_image"}],
    "video_with_roles": [{"url": "https://example.com/motion.mp4", "role": "reference_video"}],
    "audio_with_roles": [{"url": "https://example.com/voice.mp3", "role": "reference_audio"}]
  }'

{"id":"vid_01KZ3H3EXAMPLE00000000000","object":"generation.task","model":"MiniMax-H3","status":"queued","progress":0,"created_at":1785729000}

Название модели: MiniMax-H3
Поддерживаются текст-в-видео, первый/последний кадр и совместные референсы изображений, видео и аудио
Разрешение 2K, длительность 4-15 секунд
Асинхронный API возвращает унифицированный объект generation.task

Используйте публично доступные URL. Режим кадров нельзя смешивать с режимом референсов. Референсное аудио нельзя использовать без хотя бы одного изображения или видео.

Аутентификация

string

обязательно

Передайте Authorization: Bearer YOUR_API_KEY.

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

string

по умолчанию:"MiniMax-H3"

обязательно

Фиксированное значение MiniMax-H3.

string

обязательно

Описание видео, до 7000 символов.

integer

по умолчанию:5

Целое число от 4 до 15 секунд.

string

по умолчанию:"2K"

Поддерживается только 2K.

string

по умолчанию:"16:9"

Значения: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, adaptive. Для текст-в-видео нельзя использовать adaptive. Режим кадров автоматически следует входному изображению, а режим референсов по умолчанию использует adaptive.

string[]

Совместимый массив URL: 1 изображение становится первым кадром, 2 — первым и последним, 3-9 — референсами. Для новых интеграций используйте image_with_roles.

array

Массив объектов url и role. Роли: first_frame (не более 1), last_frame (не более 1), reference_image (не более 9). Форматы JPG, JPEG, PNG, WebP, HEIC, HEIF; до 30 MB, стороны 256-5760 px, соотношение 0.4-2.5.

array

До 3 референсных видео. Каждый объект содержит url и role: reference_video. MP4/MOV, до 50 MB, 2-15 секунд каждое и не более 15 секунд суммарно.

ToAPIs определяет фактическую длительность для тарификации. Не передавайте рассчитанное клиентом поле длительности.

array

До 3 референсных аудио. Каждый объект содержит url и role: reference_audio. WAV/MP3, до 15 MB, 2-15 секунд каждое и не более 15 секунд суммарно.

Нужно добавить хотя бы одно референсное изображение или видео.

boolean

по умолчанию:false

Добавить водяной знак AIGC.

string

Клиентский бизнес-ID, например номер заказа.

string

Callback завершения задачи ToAPIs. См. Webhook.

Режимы и ограничения

Режим	Вход	Соотношение
Текст-в-видео	`prompt`	Конкретное, по умолчанию `16:9`
Первый/последний кадр	`prompt` + кадры	Автоматически `adaptive`
Мультимодальные референсы	`prompt` + медиа	По умолчанию `adaptive`

Допускается до 9 изображений, 3 видео, 3 аудио и 12 медиафайлов суммарно. Роли кадров и референсов нельзя смешивать.

Пример

{
  "model": "MiniMax-H3",
  "prompt": "Следовать движениям и ритму камеры из видео 1, произнести реплику голосом из аудио 1",
  "duration": 5,
  "resolution": "2K",
  "aspect_ratio": "adaptive",
  "video_with_roles": [
    {"url": "https://example.com/motion.mp4", "role": "reference_video"}
  ],
  "audio_with_roles": [
    {"url": "https://example.com/voice.mp3", "role": "reference_audio"}
  ]
}

Ответ

string

ID задачи ToAPIs.

string

Всегда generation.task.

string

Всегда MiniMax-H3.

string

queued, in_progress, completed или failed.

integer

Прогресс 0-100.

integer

Unix-время создания в секундах.

Опрашивайте статус видеозадачи. После завершения URL находится в result.data[0].url.

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{"model":"MiniMax-H3","prompt":"Камера медленно приближается к астронавту на поверхности Луны","duration":5,"resolution":"2K","aspect_ratio":"16:9"}'

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax-H3",
    "prompt": "Сохранить персонажа из изображения 1, следовать движению камеры из видео 1 и использовать голос из аудио 1",
    "duration": 5,
    "resolution": "2K",
    "aspect_ratio": "adaptive",
    "image_with_roles": [{"url": "https://example.com/person.png", "role": "reference_image"}],
    "video_with_roles": [{"url": "https://example.com/motion.mp4", "role": "reference_video"}],
    "audio_with_roles": [{"url": "https://example.com/voice.mp3", "role": "reference_audio"}]
  }'

{"id":"vid_01KZ3H3EXAMPLE00000000000","object":"generation.task","model":"MiniMax-H3","status":"queued","progress":0,"created_at":1785729000}

MiniMax-Hailuo-2.3 Vidu Q3

Обзор

Быстрый старт

API чата

API изображений

API видео

Управление задачами

Загрузка файлов

Аккаунт

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

Генерация видео MiniMax Hailuo H3

Аутентификация

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

Режимы и ограничения

Пример

Ответ

​Аутентификация

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

​Режимы и ограничения

​Пример

​Ответ

Аутентификация

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

Режимы и ограничения

Пример

Ответ