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 - Поддерживаются текст-в-видео, первый/последний кадр и совместные референсы изображений, видео и аудио
- Для старого H3 сохраняются
2K/768pи4-15секунд. Max / Max-Turbo поддерживают480P/768Pи5-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 и 768p; значение по умолчанию — 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, например номер заказа.
Режимы и ограничения
| Режим | Вход | Соотношение |
|---|---|---|
| Текст-в-видео | prompt | Конкретное, по умолчанию 16:9 |
| Первый/последний кадр | prompt + кадры | Автоматически adaptive |
| Мультимодальные референсы | prompt + медиа | По умолчанию adaptive |
Пример
{
"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}