APIMaster.ai

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"
}