Введение
MiniMax выпустила Hailuo 2.3 28 октября 2025 года как следующий шаг после Hailuo 02 вместе с облегчённой версией Hailuo 2.3 Fast. Этот эндпоинт открывает обе модели в режиме видео из изображения: вы загружаете кадр, с которого должен начаться план, описываете, что происходит дальше, и получаете беззвучный MP4. Поле generation_mode выбирает между полной моделью и версией Fast, ничего больше в запросе не меняя.
Ключевые возможности и особенности
Движение, которое выглядит физически
MiniMax строила 2.3 вокруг плавного движения тела, более устойчивой реакции на движения камеры и убедительного света и тени. В нашем тесте в 1080p красное шёлковое платье танцовщицы продолжало качаться после поворота, а подол улёгся, а не застыл.
Лица, которые меняются постепенно
Микромимика — второй акцент этой версии. Ролик, начавшийся с нейтрального выражения, за шесть секунд может пройти через взгляд, вдох и улыбку; наш тест у дождливого окна показывает, как улыбка нарастает, пока камера наезжает.
Две модели, один формат запроса
standard и fast принимают одно и то же изображение, промпт, разрешение и длину, так что план можно набросать в Fast и перерендерить выбранный промпт в standard без переписывания. Результат повторяет пропорции первого кадра: кадр 16:9 вернулся как 1364 × 768 с частотой 24 кадра в секунду.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Опишите действие после первого кадра и движение камеры, до 5000 символов. Hailuo 2.3 беззвучен, поэтому реплики не озвучиваются. Не менее 1 символов · Не более 5000 символов |
image_url | Да | Обязательный первый кадр в JPEG, PNG или WebP до 10 МБ. Ролик сохраняет его пропорции. |
generation_mode | Нет | standard (по умолчанию) запускает Hailuo 2.3; fast — Hailuo 2.3 Fast, который готов быстрее и стоит меньше за ролик. |
resolution | Нет | 768p (по умолчанию) или 1080p. 1080p дороже и доступно только для роликов на 6 секунд. |
duration_seconds | Нет | 6 (по умолчанию) или 10 секунд. 10 секунд требуют 768p и стоят дороже за ролик. |
Стоимость
Оплата за ролик по режиму (standard или fast), разрешению и длине; отклонённые MiniMax и неудачные запросы не оплачиваются.
| Спецификация | Стоимость |
|---|---|
| $0.163 / запрос |
| $0.256 / запрос |
Сценарии использования
Движущийся ключевой визуал
Визуалы кампаний, обложки и постерная съёмка получают короткую анимированную версию для соцсетей и тизеров. Освещайте кадр так, как должна выглядеть первая секунда ролика: модель стартует именно с него.
Танец, мода и ткань
Повороты, проходки и одежда, движущаяся вокруг тела, — самый сильный материал для этой модели. Начинайте с кадра, уже пойманного в движении, и говорите, чем жест заканчивается, чтобы у ролика была точка прибытия.
Серии черновиков
Когда нужно много вариантов одного плана, рендерьте их в Fast в 768p, сравнивайте и тратьте режим standard или 1080p только на версию, которая выйдет в публикацию.
Руководство по промптам и практические советы
Сначала действие, потом камера
Пишите промпт как короткое описание плана: кто движется, что происходит, чем заканчивается и что делает камера. Например, женщина отворачивается от окна, убирает прядь за ухо и улыбается, пока камера наезжает. Несколько несвязанных действий в шести секундах обычно смешиваются.
Уважайте загруженный кадр
Первый кадр задаёт костюм, свет и композицию. Описывайте изменения, которые могут из него вырасти — поворот, шаг, порыв ветра, — а не новый наряд или место, которых в первом кадре нет.
Планируйте длину и размер вместе
Ролики на 10 секунд доступны только в 768p, а 1080p длится 6 секунд. Оставайтесь в рамках намёка: MiniMax проверяет промпты и готовые ролики, откровенные формулировки отклоняются сразу, а сцены, уходящие в более откровенную сторону, могут сорваться через несколько минут. Ни один такой запрос не оплачивается.
Быстрый старт API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "minimax/hailuo-2.3/image-to-video",
"input": {
"duration_seconds": 6,
"generation_mode": "standard",
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "768p"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.























