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
Генерация видео MiniMax Hailuo H3
Генерация видео MiniMax Hailuo H3 в 2K или 768p по тексту, первому/последнему кадру и мультимодальным референсам
POST
/
v1
/
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}
Для пользователей из материкового Китая: используйте
https://toapis.cn в качестве эндпоинта (Base URL). Замените https://toapis.com на https://toapis.cn во всех примерах этого документа.- Поддерживаются три модели:
MiniMax-H3,MiniMax-H3-MaxиMiniMax-H3-Max-Turbo MiniMax-H3иMiniMax-H3-Maxподдерживают текст-в-видео, первый/последний кадр и совместные референсы изображений, видео и аудиоMiniMax-H3-Max-Turboподдерживает только текст-в-видео и первый/последний кадр, без референсных медиа- Для старого H3 сохраняются
2K/768pи4-15секунд. Max / Max-Turbo поддерживают480P/768Pи5-15секунд - Асинхронный API возвращает унифицированный объект
generation.task
MiniMax-H3-Max-Turbo не поддерживает reference_image, reference_video и reference_audio. При отправке референсных медиа возвращается ошибка MiniMax-H3-Max-Turbo does not support reference media. Для референсных видео используйте MiniMax-H3 или MiniMax-H3-Max.Используйте публично доступные URL. Режим кадров нельзя смешивать с режимом референсов. Референсное аудио нельзя использовать без хотя бы одного изображения или видео.
Аутентификация
string
обязательно
Передайте
Authorization: Bearer YOUR_API_KEY.Параметры запроса
string
по умолчанию:"MiniMax-H3"
обязательно
Выберите
MiniMax-H3, MiniMax-H3-Max или MiniMax-H3-Max-Turbo. Мультимодальные референсы поддерживают только MiniMax-H3 и MiniMax-H3-Max; Turbo поддерживает только текст-в-видео и первый/последний кадр.string
обязательно
Описание видео, до
7000 символов.integer
по умолчанию:5
MiniMax-H3: целое число от 4 до 15 секунд; Max / Max-Turbo: от 5 до 15 секунд.string
по умолчанию:"2K"
MiniMax-H3 поддерживает 2K и 768p; Max / Max-Turbo поддерживают 480P и 768P.string
по умолчанию:"16:9"
Значения:
21:9, 16:9, 4:3, 1:1, 3:4, 9:16, adaptive.
Для текст-в-видео нельзя использовать adaptive. Режим кадров автоматически следует входному изображению, а режим референсов по умолчанию использует adaptive.
Режим референсов доступен только для MiniMax-H3 и MiniMax-H3-Max.string[]
Совместимый массив URL: 1 изображение становится первым кадром, 2 — первым и последним, 3-9 — референсами. Для новых интеграций используйте
image_with_roles.
Ввод 3-9 референсных изображений поддерживают только MiniMax-H3 и MiniMax-H3-Max; Turbo его не поддерживает.array
Массив объектов
url и role. Роли: first_frame (не более 1), last_frame (не более 1), reference_image (не более 9).
reference_image поддерживают только MiniMax-H3 и MiniMax-H3-Max; Turbo поддерживает только first_frame и last_frame.
Форматы JPG, JPEG, PNG, WebP, HEIC, HEIF; до 30 MB, стороны 256-5760 px, соотношение 0.4-2.5.array
Поддерживается только моделями
MiniMax-H3 и MiniMax-H3-Max, но не Turbo.
До 3 референсных видео. Каждый объект содержит url и role: reference_video. MP4/MOV, до 50 MB, 2-15 секунд каждое и не более 15 секунд суммарно.
ToAPIs определяет фактическую длительность для тарификации. Не передавайте рассчитанное клиентом поле длительности.
array
Поддерживается только моделями
MiniMax-H3 и MiniMax-H3-Max, но не Turbo.
До 3 референсных аудио. Каждый объект содержит url и role: reference_audio. WAV/MP3, до 15 MB, 2-15 секунд каждое и не более 15 секунд суммарно.
Нужно добавить хотя бы одно референсное изображение или видео.
boolean
по умолчанию:false
Добавить водяной знак AIGC.
string
Клиентский бизнес-ID, например номер заказа.
Режимы и ограничения
| Режим | Поддерживаемые модели | Вход | Соотношение |
|---|---|---|---|
| Текст-в-видео | Все три модели | prompt | Конкретное, по умолчанию 16:9 |
| Первый/последний кадр | Все три модели | prompt + кадры | Автоматически adaptive |
| Мультимодальные референсы | Только MiniMax-H3 и MiniMax-H3-Max | prompt + медиа | По умолчанию adaptive |
MiniMax-H3 и MiniMax-H3-Max.
Допускается до 9 изображений, 3 видео, 3 аудио и 12 медиафайлов суммарно. Роли кадров и референсов нельзя смешивать.
Пример
В примерах с референсными медиа используетсяMiniMax-H3. Простая замена model на MiniMax-H3-Max-Turbo не поддерживается. Для MiniMax-H3-Max задайте resolution как 480P или 768P, а duration от 5 до 15 секунд.
{
"model": "MiniMax-H3",
"prompt": "Следовать движениям и ритму камеры из видео 1, произнести реплику голосом из аудио 1",
"duration": 5,
"resolution": "768p",
"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}