MiniMax Hailuo 02

minimax-hailuo-02

MiniMax Hailuo 02 — генерация видео от MiniMax, доступная через единый Ranvik API. Поддерживаемые возможности: high_quality, image_to_video, text_to_video.

от 56 ₽ / сек

Карточка модели

Технические характеристики

МодальностьГенерация видео

Провайдерminimax

СтатусАктивна

ID для запросовminimax-hailuo-02

Возможности

Высокое качество
Image-to-video
Text-to-video

Цены

Единица	Цена
за секунду · Hailuo 02	56 ₽

Цены указаны в рублях. Списываются с баланса проекта при каждом успешном запросе.

Поддерживаемые параметры

Параметры передаются вендору как есть (pure proxy) — мы не валидируем их у себя на стороне. Если вендор не примет — вернётся его ошибка.

Параметр	Тип	Диапазон / values	Default	Описание
`prompt`required	string	max: 2000	—	Текстовое описание видео (до 2000 символов). Поддерживает camera control в квадратных скобках, напр. [Pedestal up], [Static shot]. примеры значений Примеры Девушка в красном платье танцует под дождём в неоновом мегаполисе.
`duration`	integer	6, 10	6	Длительность видео в секундах. 6 (default) или 10. Для 10s доступно только 768P.
`resolution`	enum	768P, 1080P	768P	Разрешение. 768P (default) или 1080P. 1080P только для duration=6.
`first_frame_image`	string	—	—	Стартовый кадр для image-to-video (URL или Base64). Включает I2V-режим — модель Hailuo автоматически переключается на Fast-вариант. примеры значений Примеры https://example.com/start.jpg
`prompt_optimizer`	boolean	—	true	Авто-оптимизация prompt через LLM rewriting перед генерацией.
`fast_pretreatment`	boolean	—	false	Ускоренная препроцессинговая фаза (только для Hailuo-2.3 / Hailuo-02).
`callback_url`	string	—	—	URL для POST-уведомления о завершении генерации. примеры значений Примеры https://yourapp.com/webhooks/minimax

Параметры ответа

Что возвращает API. У медиа-моделей формат зависит от режима: sync — сразу результат, async — task_id для опроса через GET /v1/tasks/{id}. Эта модель работает только в async-режиме.

Async (HTTP 202)

HTTP 202. Видео-генерация всегда async — нет sync-режима.

Поле	Тип	Значения	Описание
`id`	string	—	task_id для GET /v1/tasks/{id}.
`object`	string	video.task
`status`	enum	queued, processing, completed, failed
`model`	string	—
`created`	integer	—

Опрос статуса (GET /v1/tasks/{id})

GET /v1/tasks/{id} — опрос статуса.

Поле	Тип	Значения	Описание
`id`	string	—
`status`	enum	queued, processing, completed, failed, canceled
`modality`	string	video
`model`	string	—
`data`	array	—	Каждый элемент: `url`— string · CDN URL .mp4 / .webm / .mov.
`error`	string	—

Пример запроса

from openai import OpenAI

client = OpenAI(api_key="rk_live_...", base_url="https://api.ranvik.ru/v1")
resp = client.videos.generate(
    model= "minimax-hailuo-02",
    prompt= "Пример промпта",
    duration= 6,
    resolution= "768P",
    first_frame_image= "https://example.com/input.png",
    prompt_optimizer= True,
    fast_pretreatment= False,
    callback_url= "https://example.com/...",
)
print(resp)

Замените rk_live_... на ваш ключ из кабинета.

О провайдере: MiniMax

MiniMax — китайская AI-лаборатория. Известна моделями TTS высокого качества (Speech) с поддержкой многоязычной речи и клонирования голоса, а также видеогенератором Hailuo.

Официальный сайт: https://minimaxi.com

Документация модели у вендора: https://www.minimax.io/platform/document/api-reference