Перейти к основному содержанию
MiniMax H3 — универсальная мультимодальная модель видео от MiniMax: на вход принимает текст, изображения, видео и аудио, а на выходе отдаёт видео со своей музыкой и звуковыми эффектами. LaoZhang API берёт плату за длину видео, $0.05 за секунду при 768P — на 37.5% ниже официальной цены MiniMax. Вызвать модель может токен любой стандартной группы.
MiniMax H3 доступна только через нативные эндпоинты /hailuo/v2, указанные выше. Запросы к /v1/videos и /v1/video/generations отклоняются и не оплачиваются.
Пример MiniMax H3 «текст в видео»: рыжий кот идёт по мокрой крыше в сумерках, за ним огни города

Результат примера «текст в видео» ниже: 768P, 5 секунд, 16:9

Создание токена

В разделе Управление токенами добавьте токен с такими настройками: Аккаунт MiniMax и отдельная группа для видео не нужны.

Цены

MiniMax H3 оплачивается за длину видео. Цены на 24 октября 2026 года: Официальные цены взяты со страницы цен MiniMax с оплатой по факту использования (MiniMax-H3, проверено 24 октября 2026 года). Горизонтальное, вертикальное и квадратное видео стоят одинаково: значение имеют только разрешение и число секунд. Как считаются оплачиваемые секунды:
  • Выход: запрошенное значение duration. Ролики обычно получаются на 0.1–0.5 секунды длиннее запрошенного без доплаты.
  • Референсное видео: его длина, округлённая вверх до целой секунды; ролик в 5.8 секунды считается как 6 секунд.
  • Референсные изображения: изображения сверх первых 5 в одной задаче оплачиваются по отдельности, при этом изображения первого и последнего кадров входят в общее число.
Примеры стоимости одного видео:
  • 768P, 5 секунд, текст в видео: 5 × $0.05 = $0.25
  • 2K, 10 секунд, текст в видео: 10 × $0.08 = $0.80
  • 768P, 4 секунды с референсным видео на 6 секунд: (4 + 6) × $0.05 = $0.50
При создании задачи с баланса резервируется сумма «длительность × тариф» вместе с оплатой изображений сверх первых пяти. Для задач с референсным видео секунды референса списываются после завершения задачи, поэтому в журнале вызовов появляется вторая запись расчёта. Неудавшиеся задачи возвращаются полностью, а запросы, отклонённые при отправке, не оплачиваются. Повторная отправка создаёт новую задачу и оплачивается снова, поэтому храните соответствие между вашим ID и task_id. Точная сумма по каждой задаче видна в журнале вызовов.

Примеры результатов

Эти ролики — необработанный результат MiniMax-H3 со звуковой дорожкой, которую сгенерировала модель. Нажмите на ролик, чтобы воспроизвести его. В подписи указаны разрешение, длина, соотношение сторон и промпт. Примеры видео Muse сделаны по тем же промптам, так что модели можно сравнить сцену за сценой.

768P, 6 секунд, 16:9. Промпт: A red fox walking through snowy forest at sunrise, cinematic

2K (2560×1440), 6 секунд, 16:9, тот же промпт, что и в предыдущем ролике

768P, 10 секунд, 16:9. Промпт: A paper boat drifts down a rainy city gutter, then sails into a small sunny pond

768P, 10 секунд, 16:9. Промпт: A hot air balloon rises over a valley at dawn, drifts over a river and a village, then lands in a meadow

768P, 10 секунд, вертикальное 9:16. Промпт: A cyclist rides through a coastal town from morning to sunset: market, harbor, cliff road, lighthouse

Как это работает

1

Создайте задачу

Отправьте POST /hailuo/v2/video_generation с JSON-телом, в котором есть:
  • model: MiniMax-H3
  • content: один текстовый элемент и, при необходимости, изображения, видео или аудио
  • resolution, duration и ratio
Сохраните task_id из ответа.
2

Опрашивайте задачу

Вызывайте GET /hailuo/v2/query/video_generation/{task_id} каждые 10 секунд и читайте task.status. Видео 4–5 секунд в 768P обычно готово примерно за минуту; задачи в 2K и с референсным видео занимают дольше. Задайте на клиенте общий таймаут 30 минут.
3

Скачайте видео

Когда task.status станет succeeded, скачайте MP4 по task.content.url. Ссылка действует 7 дней, и заголовок Authorization для неё не нужен.

Подготовка

В примерах cURL поля ответов читает jq (на macOS установите его командой brew install jq). Сначала задайте ключ и базовый URL:

Видео по тексту

Успешный запрос возвращает только ID задачи:
Для запросов только с текстом нужно задать конкретное значение ratio: adaptive без изображения не принимается.

Анимация по первому кадру или по первому и последнему кадрам

Передайте first_frame, чтобы задать начальный кадр, и добавьте last_frame, чтобы задать и финальный. Если ratio равно adaptive, соотношение сторон результата повторяет первый кадр:
Изображения могут быть публичными HTTPS-ссылками или data URL в Base64, например data:image/jpeg;base64,.... Чтобы задать только первый кадр, уберите элемент last_frame.

Генерация по референсным изображениям, видео и аудио

Референсы позволяют поместить в сцену конкретного персонажа или предмет, повторить движение и работу камеры из ролика или подстроиться под ритм аудиодорожки. В промпте ссылайтесь на них по типу и порядку: первое референсное изображение — <Picture 1>, первое референсное видео — <Video 1>, первое референсное аудио — <Audio 1>.
Что учесть при сочетании референсов:
  • Референсные изображения, видео и аудио можно свободно комбинировать, но аудио не может быть единственным референсом: добавьте хотя бы одно референсное изображение или видео.
  • Первый и последний кадры нельзя использовать в одном запросе с референсами.
  • Видео и аудио должны быть публичными HTTPS-ссылками, которые сервис может скачать напрямую.
  • Референсное видео оплачивается посекундно; см. раздел «Цены».

Опрос и скачивание

Получение задачи

Повторяйте запрос каждые 10 секунд, пока task.status не станет succeeded или failed. Успешный ответ:
В usage указаны оплаченные секунды задачи: input_seconds — референсное видео, output_seconds — сгенерированное видео.

Скачивание видео

Ссылка действует 7 дней, поэтому скопируйте файл в собственное хранилище вскоре после завершения задачи.

Минимальный клиент на Python

Скрипт использует только стандартную библиотеку Python. Перед запуском задайте LAOZHANG_API_KEY. Он опрашивает задачу каждые 10 секунд с общим таймаутом 30 минут и сохраняет результат как h3-output.mp4.

Справочник API

Основы запроса

Тело запроса

adaptive повторяет соотношение сторон изображения и не подходит для запросов только с текстом или только с аудио. При 16:9 результат 768P имеет размер 1344×768, а 2K — 2560×1440.

Входные данные content[]

Если изображение одно, role можно не указывать: оно будет считаться первым кадром. Если изображений два и больше, задайте role для каждого.

Статусы задачи

В загруженные часы задача может некоторое время оставаться в статусе queued и запускается автоматически в порядке отправки. Задача, не начавшаяся за 30 минут, переходит в failed и возвращается.

Ошибки

Часть сообщений о проверке параметров приходит на китайском, как показано выше. В рабочей среде сохраняйте task_id из ответа на создание и итоговые данные задачи, чтобы сверять списания или обращаться в поддержку (hi@laozhang.ai).

Частые вопросы

Сколько стоит видео на 5 секунд?

$0.25 при 768P и $0.40 при 2K. Стоимость растёт линейно с длиной, так что 15 секунд в 768P обойдутся в $0.75. Референсное видео добавляет свои секунды по тому же тарифу, а каждое референсное изображение сверх первых пяти — $0.03; подробности — в разделе «Цены».

Что выбрать: 768P или 2K?

Подбирайте промпт и композицию в 768P на роликах по 4–5 секунд, а финальную версию рендерите в 2K или с большей длительностью. 2K стоит на $0.03 дороже за секунду и генерируется дольше, поэтому его лучше оставить для материала, который пойдёт на большой экран или в дальнейший монтаж.

Можно ли вызвать MiniMax H3 через OpenAI-подобный эндпоинт /v1/videos?

Нет. Первый и последний кадры, несколько референсных изображений, референсное видео и референсное аудио опираются на структуру content[], поэтому LaoZhang API предоставляет MiniMax H3 только на нативных эндпоинтах /hailuo/v2. Запросы к /v1/videos и /v1/video/generations отклоняются без списания.

Есть ли в видео звук и можно ли его отключить?

В каждом видео есть стереодорожка: музыка и эффекты следуют промпту и референсному аудио. Параметра для отключения звука нет; если он не нужен, уберите аудиодорожку после скачивания.

Можно ли отправить запрос повторно после таймаута или ошибки?

Сначала проверьте задачу. Таймаут на стороне клиента не означает, что задача не выполнена, поэтому продолжайте опрашивать тот же task_id: повторная отправка создаёт новую задачу и оплачивается снова. Создавать запрос заново нужно только после того, как task.status стал failed; по неудавшейся задаче деньги уже возвращены.

Как долго хранятся ссылки на видео?

7 дней. Затем ссылка перестаёт работать, и задачу нельзя скачать повторно, поэтому сохраняйте файл сразу после завершения задачи.

Связанные материалы