API генерации видео MiniMax-H3
Создавайте асинхронные видеозадачи MiniMax-H3 через APIMaster, проверяйте статус и скачивайте MP4.
Генерация видео MiniMax-H3
Используйте MiniMax-H3 через совместимый с OpenAI видео API APIMaster. Генерация выполняется асинхронно.
Базовый URL:
https://apimaster.ai/v1— этоhttps://apimaster.ai/v1. Создавайте задачи черезPOST https://apimaster.ai/v1/video/generations.
Совместимость и проверка параметров
Поддерживаются POST https://apimaster.ai/v1/video/generations и POST https://apimaster.ai/v1/videos/generations. Для одной модели параметры и правила оплаты одинаковы; каждый путь сохраняет прежний формат ответа при создании. Существующим клиентам менять путь не нужно.
Пример MiniMax-H3 сохраняет единственное число; size и resolution, а также ratio и aspect_ratio — синонимы. Неподдерживаемые значения или противоречивые синонимы возвращают HTTP 400 без скрытого перехода к более высокому разрешению. Указывайте разрешение, пропорции и длительность явно.
Создание задачи
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
model |
string | да | MiniMax-H3 |
prompt |
string | условно | Описание видео |
duration |
integer | нет | 4–15 секунд, по умолчанию 4 |
size |
string | нет | 768P или 2K, по умолчанию 768P |
ratio |
string | нет | Соотношение сторон, по умолчанию 16:9 |
curl -s "https://apimaster.ai/v1/video/generations" \
-H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"model":"MiniMax-H3","prompt":"A calm ocean at sunrise, cinematic wide shot","duration":4,"size":"768P","ratio":"16:9"}'
Ответ сразу содержит id и task_id со статусом queued.
Проверка статуса
GET https://apimaster.ai/v1/videos/{task_id} возвращает queued, in_progress, completed или failed.
curl -s "https://apimaster.ai/v1/videos/task_xxxxxxxx" -H "Authorization: Bearer YOUR_API_KEY"
После отправки подождите 10–20 секунд, затем проверяйте задачу каждые 3–5 секунд.
Скачивание видео
curl -L "https://apimaster.ai/v1/videos/task_xxxxxxxx/content" \
-H "Authorization: Bearer YOUR_API_KEY" -o output.mp4
Скачивайте MP4 после статуса completed. duration: 4–15 секунд; size: 768P или 2K.
Видео по референсам (r2v)
Отправьте официальный массив V2 content на указанный выше эндпоинт APIMaster. Нужен непустой элемент text; при наличии content поле prompt верхнего уровня не обязательно. reference_image задаёт ориентир для объекта или стиля, а не фиксирует первый кадр. Старое поле images использует первые два изображения как начальный и конечный кадры. Не смешивайте эти роли с референсами.
{
"model": "MiniMax-H3",
"content": [
{"type": "text", "text": "Use the character in Image 1 as the subject, walking through a garden."},
{"type": "image_url", "image_url": {"url": "https://YOUR_PUBLIC_IMAGE_URL/reference.jpg"}, "role": "reference_image"}
],
"resolution": "768P",
"duration": 4,
"ratio": "16:9"
}
