MiniMax Hailuo 03 API: генерация видео 1080p

Создавайте AI-видео 1080p через MiniMax Hailuo 03 API: текст-в-видео, изображение-в-видео, async-задачи, цена $0.08/сек и советы для разработчиков.

Туториал

Если вам нужно AI-видео 1080p через API, основные ограничения просты: ролики до 5 секунд, обработка async-задач и стоимость $0.08/сек. Я бы рассматривал Hailuo 03 как модель короткого видео для приложений, которым нужно текст-в-видео или изображение-в-видео без запуска GPU.

Вот статья простыми словами:

Что он делает: генерирует видео MP4 1080p
Типы входов: текстовый промпт, изображение-в-видео, первый-и-последний кадр и субъектный референс
Лимит ролика: 5 секунд при 1080p
Цена: $0.40 за 5-секундный ролик 1080p
Поток API: отправьте задачу, затем опрашивайте task_id или используйте callback_url
Управление промптом: движения камеры в скобках вроде [Pan left] или [Zoom in]
Работа с файлами: финальный URL видео истекает через 24 часа
Правила изображений: меньше 20 МБ и соотношение сторон между 2:5 и 5:2
Замечание о надёжности: в статье указан SLA 99.9% аптайма

Главное вот что: вам нужна бэкенд-логика, а не просто промпт. Это значит обрабатывать асинхронные проверки статуса, сразу сохранять MP4, повторять запросы при 429 и 5xx и склеивать ролики, если нужно что-то длиннее 5 секунд.

Если бы я это настраивал, я бы сначала тестировал промпты в более низком разрешении, фиксировал формулировку движения, а затем переходил к 1080p только для финальных прогонов, чтобы держать расходы под контролем.

Смотрите: автоматизация генерации видео MiniMax

Основные возможности и опции вывода 1080p

Перед отправкой первого запроса разберитесь с режимами входа Hailuo 03, управлением движением и лимитами вывода.

Поддерживаемые входы: текстовые промпты, изображения и инструкции движения

Hailuo 03 поддерживает четыре режима входа: текст-в-видео, изображение-в-видео (I2V), видео по первому и последнему кадру и видео с субъектным референсом ^[2].

Для управления движением можно объединить до трёх движений камеры внутри одной инструкции в скобках, например [Pan left, Pedestal up] ^[3]. Это даёт простой способ направлять кадрирование и движение сцены без добавления лишних метаданных.

Эти режимы соответствуют полям запроса, описанным в следующем разделе.

Спецификации вывода 1080p, которые разработчикам стоит проверить

Вывод 1080p ограничен 5-секундными роликами. Если нужна более длинная последовательность, сгенерируйте несколько роликов и склейте их на бэкенде. Для проектов, требующих встроенного звука, рассмотрите Veo 3.1 от Google как альтернативу.

Этот лимит должен формировать и настройки запроса, и логику сборки на бэкенде.

Спецификации Hailuo 03

Спецификация	Детали
Режимы входа	Текст-в-видео, изображение-в-видео, видео по первому и последнему кадру, видео с субъектным референсом
Управление движением	До трёх движений камеры на инструкцию в скобках
Макс. длина ролика	5 секунд
Разрешение вывода	1080p

Как вызвать MiniMax Hailuo 03 API на APIMart

MiniMax Hailuo 03

Теперь, когда вы увидели, что умеет Hailuo 03, пора подключить его к вашему приложению.

Аутентификация, базовый URL и заголовки

Каждый запрос к APIMart использует Bearer-токен в заголовке Authorization вместе с Content-Type: application/json. Один API-ключ APIMart обрабатывает каждый запрос.

POST https://api.apimart.ai/v1/videos/generations

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Примеры запросов для текст-в-видео и изображение-в-видео

Вы будете использовать один и тот же эндпоинт и одну и ту же настройку аутентификации каждый раз. Меняются промпт, разрешение, длительность и URL входа.

Поле model указывает на Hailuo 03. resolution управляет качеством вывода. И если вы хотите 1080p, duration должна быть 5.

Запрос текст-в-видео:

{
  "model": "MiniMax-Hailuo-03",
  "prompt": "A product designer sketching at a sunlit desk, [Pan left, Zoom in], cinematic depth of field",
  "resolution": "1080p",
  "duration": 5,
  "prompt_optimizer": true
}

Запрос изображение-в-видео:

{
  "model": "MiniMax-Hailuo-03",
  "prompt": "The product rotates slowly on a white surface, [Orbit right]",
  "resolution": "1080p",
  "duration": 5,
  "first_frame_image": "https://your-storage.com/product-shot.jpg",
  "prompt_optimizer": true
}

Для изображения-в-видео сначала загрузите изображение и используйте возвращённый URL в first_frame_image. Изображение должно быть меньше 20 МБ, а его соотношение сторон должно оставаться между 2:5 и 5:2. Если оно выходит за эти пределы, API возвращает ошибку 400. Установите prompt_optimizer в true, если хотите доработать промпт перед генерацией.

Асинхронные ответы, статус задачи и финальные URL видео

Генерация видео выполняется асинхронно, поэтому вашему приложению нужно опрашивать статус или использовать колбэк.

«После отправки задачи опрашивайте её статус через task_id, пока она не завершится успехом или ошибкой.» — Документация MiniMax API ^[2]

Опрашивайте этот эндпоинт каждые 15–30 секунд:

GET https://api.apimart.ai/v1/tasks/{task_id}

Поле status проходит через несколько стадий:

Статус	Значение
`submitted` / `Preparing`	Запрос получен, инициализация
`queued` / `Queueing`	Ожидание ресурсов GPU
`processing`	Видео активно рендерится
`completed` / `Success`	Готово — URL видео доступен
`failed` / `Fail`	Произошла ошибка; проверьте `error_message`

Когда статус достигает completed, ответ включает финальный URL MP4. Скачайте MP4 сразу, потому что ссылка истекает через 24 часа ^[4].

Если вы обрабатываете много задач, передайте callback_url в первом запросе вместо опроса. Ваш сервер получит POST-колбэк, когда задача завершится, и должен вернуть значение проверки в течение 3 секунд ^[3].

Когда поток задач настроен, следующий шаг — отладить качество и стоимость для производства. Можно также рассмотреть Kling V3 для альтернативных кинематографичных стилей видео.

Параметры, производительность и цены для нагрузок 1080P

Контроль качества, который важен в производстве

Когда формат запроса задан, следующий шаг — настройка качества вывода, скорости и расходов. Для большинства задач 1080P три настройки делают основную работу: resolution, duration и prompt_optimizer.

prompt_optimizer переписывает промпты, чтобы движение и композиция были яснее ^[1]^[3]. В большинстве производственных случаев его лучше оставить включённым. Но если ваш промпт должен строго придерживаться брендовых терминов или точной формулировки, установите его в false, чтобы система не переписывала текст, который вам нужно сохранить ^[3].

Можно также использовать fast_pretreatment, чтобы сократить время подготовки промпта. Компромисс — небольшое снижение качества вывода ^[1]^[3].

Для движения камеры помещайте указания движения прямо в промпт командами в скобках. Примеры: [Pan left] и [Zoom in]. Можно использовать до трёх таких команд в одном промпте ^[3]^[5].

Планирование задержки и стоимости в USD

После настройки этих параметров стоимость в основном сводится к длине ролика. Поскольку генерация выполняется асинхронно, планируйте поток «отправить и опросить». Если хотите, чтобы бэкенд получал результат автоматически, используйте callback_url, чтобы он получал уведомление по завершении задачи ^[4].

При $0.08 за секунду 5-секундный ролик 1080P стоит $0.40.

Один простой способ сократить расходы — сначала тестировать промпты в 768P, затем переключаться на 1080P, когда поведение промпта и движение камеры выглядят правильно ^[1]^[6].

Паттерны интеграции и следующие шаги

Бэкенд-процесс для маркетинговых, продуктовых и образовательных приложений

С настроенной обработкой запросов и статуса задач следующий шаг — встраивание Hailuo 03 в реальные продуктовые потоки. Базовый поток задач остаётся одинаковым для разных типов приложений. Меняется стиль промпта, отправляемый вход и то, что должен делать ролик.

Для рекламных роликов используйте текст-в-видео. Держите промпты короткими и прямыми и включайте подсказки камеры вроде [Pan left] или [Tracking shot]. Для визуала товаров используйте изображение-в-видео и передавайте кадры товара как референсное изображение. Для образовательных пояснялок 768P часто практичнее, когда нужны более длинные ролики.

Хранение, доставка и учёт использования в масштабе

После завершения рендера переместите файл в постоянное хранилище для доставки и учёта. Скачивайте каждый MP4 сразу и сохраняйте его в собственной системе для доставки. Для надёжности добавьте экспоненциальную задержку при ответах 429 и 5xx. Если обрабатываете большой объём, используйте callback_url вместо опроса. Отслеживайте использование в одном месте по всем видеозадачам. Такая настройка помогает держать доставку стабильной по мере роста объёма.

Заключение: ключевые моменты для разработчиков

Отправляйте задачи с правильным типом входа для сценария, аккуратно обрабатывайте асинхронный поток и сразу сохраняйте вывод — а дальше стройте на этом.

Часто задаваемые вопросы

Сколько обычно занимает генерация видео 1080p?

Высококачественная генерация видео 1080p обычно занимает от 1 минуты 38 секунд до 5 минут, хотя некоторые задачи завершаются за 30–90 секунд.

Точное время зависит от двух вещей: насколько сложен ваш промпт и какой длины видео вам нужно. Поскольку генерация выполняется асинхронно, ваше приложение должно опрашивать статус задачи до её завершения.

Как лучше всего сделать видео длиннее 5 секунд?

Чтобы создать видео длиннее 5 секунд через MiniMax Hailuo API, используйте более низкое разрешение.

1080p поддерживает только 5- или 6-секундные ролики в зависимости от версии модели. 768p поддерживает ролики до 10 секунд.

Поэтому, если хотите 10-секундное видео, задайте:

resolution в 768p
duration в 10

В вашем API-запросе это должно выглядеть так на практике: используйте 768p для разрешения и 10 для длительности.

Когда стоит отключать prompt_optimizer?

Отключайте prompt_optimizer, когда хотите более жёсткого контроля над выводом видео. По умолчанию система переписывает ваше описание, чтобы улучшить результат.

Отключите его, если хотите, чтобы промпт использовался точно так, как написан, особенно если вы уже отладили его и не хотите, чтобы что-то менялось.