MiniMax H3
hailuo/minimax-h3MiniMax H3 (Hailuo 03) — это унифицированная мультимодальная модель генерации видео, которая превращает текст, изображения, видео и аудиоматериалы в готовые ролики разрешением 2K со встроенным стереозвуком. Создавайте оригинальные сцены, оживляйте статичные кадры, монтируйте существующие видеоматериалы — всё через единый MiniMax H3 API.
Обзор
MiniMax H3 (Hailuo 03) — это унифицированная мультимодальная модель генерации видео, которая превращает текст, изображения, видео и аудиоматериалы в готовые ролики разрешением 2K со встроенным стереозвуком. Создавайте оригинальные сцены, оживляйте статичные кадры, монтируйте существующие видеоматериалы — всё через единый MiniMax H3 API.
Аутентификация
Все API-запросы требуют валидный API-ключ, переданный в заголовке Authorization по схеме Bearer.
Быстрый старт
Учётные данные
Задайте переменную окружения RUNBASE_API_KEY.
export RUNBASE_API_KEY=your-api-keyСоздать запуск
curl -s https://runbase.net/api/v1/runs \
-H "Authorization: Bearer $RUNBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "hailuo/minimax-h3",
"input": {
"prompt": "A cinematic product photo of a ceramic lamp"
}
}'Запуски
Запуски обрабатываются асинхронно. Отправьте запрос, затем опрашивайте статус для получения результата.
Создать запуск
curl -s https://runbase.net/api/v1/runs \
-H "Authorization: Bearer $RUNBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "hailuo/minimax-h3",
"input": { "prompt": "A cinematic product photo of a ceramic lamp" }
}'Получить статус запуска
curl -s https://runbase.net/api/v1/runs/RUN_ID \
-H "Authorization: Bearer $RUNBASE_API_KEY"Получить результат
Опрашивайте эндпоинт статуса, пока status не станет "succeeded", затем прочитайте output.urls из ответа.
Схема входных данных
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| prompt | string | Обязательный | PromptДо 7000 символов |
| aspect_ratio | string | Необязательный | Aspect ratioПараметры: 16:99:161:14:33:421:9По умолчанию: 16:9 |
| resolution | string | Необязательный | 2K requires at least one reference image; text-only generation supports 768p only.Параметры: 768p2kПо умолчанию: 768p |
| duration | number | Необязательный | Duration (seconds)Диапазон: 4–15По умолчанию: 5 |
| image_urls | string[] | Необязательный | Reference imagesДо 5 изображений |
Схема выходных данных
| Поле | Тип | Описание |
|---|---|---|
| urls | string[] | URL сгенерированных результатов |
Ошибки
API использует стандартные HTTP-коды для индикации успеха или ошибки.
| Код статуса | Описание |
|---|---|
| 400 | Ungültige Anfrage – fehlende oder fehlerhafte Parameter |
| 401 | Authentifizierung fehlgeschlagen – fehlender oder ungültiger API-Schlüssel |
| 402 | Unzureichendes Guthaben |
| 403 | Zugriff verweigert – IP nicht erlaubt, Konto gesperrt oder Ausgabenlimit des API-Schlüssels überschritten |
| 404 | Ausführung nicht gefunden |
| 429 | Rate-Limit überschritten |
| 500 | Interner Serverfehler |

