
Результат примера «текст в видео» ниже: 768P, 5 секунд, 16:9
Создание токена
В разделе Управление токенами добавьте токен с такими настройками:Цены
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
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
Как это работает
Создайте задачу
POST /hailuo/v2/video_generation с JSON-телом, в котором есть:model:MiniMax-H3content: один текстовый элемент и, при необходимости, изображения, видео или аудиоresolution,durationиratio
task_id из ответа.Опрашивайте задачу
GET /hailuo/v2/query/video_generation/{task_id} каждые 10 секунд и читайте task.status. Видео 4–5 секунд в 768P обычно готово примерно за минуту; задачи в 2K и с референсным видео занимают дольше. Задайте на клиенте общий таймаут 30 минут.Скачайте видео
task.status станет succeeded, скачайте MP4 по task.content.url. Ссылка действует 7 дней, и заголовок Authorization для неё не нужен.Подготовка
В примерах cURL поля ответов читаетjq (на macOS установите его командой brew install jq). Сначала задайте ключ и базовый URL:
Видео по тексту
ratio: adaptive без изображения не принимается.
Анимация по первому кадру или по первому и последнему кадрам
Передайтеfirst_frame, чтобы задать начальный кадр, и добавьте last_frame, чтобы задать и финальный. Если ratio равно adaptive, соотношение сторон результата повторяет первый кадр:
data:image/jpeg;base64,.... Чтобы задать только первый кадр, уберите элемент last_frame.
Генерация по референсным изображениям, видео и аудио
Референсы позволяют поместить в сцену конкретного персонажа или предмет, повторить движение и работу камеры из ролика или подстроиться под ритм аудиодорожки. В промпте ссылайтесь на них по типу и порядку: первое референсное изображение —<Picture 1>, первое референсное видео — <Video 1>, первое референсное аудио — <Audio 1>.
- Референсные изображения, видео и аудио можно свободно комбинировать, но аудио не может быть единственным референсом: добавьте хотя бы одно референсное изображение или видео.
- Первый и последний кадры нельзя использовать в одном запросе с референсами.
- Видео и аудио должны быть публичными HTTPS-ссылками, которые сервис может скачать напрямую.
- Референсное видео оплачивается посекундно; см. раздел «Цены».
Опрос и скачивание
Получение задачи
task.status не станет succeeded или failed. Успешный ответ:
usage указаны оплаченные секунды задачи: input_seconds — референсное видео, output_seconds — сгенерированное видео.
Скачивание видео
Минимальный клиент на 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; по неудавшейся задаче деньги уже возвращены.