> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laozhang.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MiniMax H3 (Hailuo): API видео, цены за секунду

> Как создать видео по тексту, первому и последнему кадрам или референсам через MiniMax H3, опросить задачу, скачать MP4 и сравнить цены 768P и 2K.

MiniMax H3 — универсальная мультимодальная модель видео от MiniMax: на вход принимает текст, изображения, видео и аудио, а на выходе отдаёт видео со своей музыкой и звуковыми эффектами. LaoZhang API берёт плату за длину видео, \$0.05 за секунду при 768P — на 37.5% ниже официальной цены MiniMax. Вызвать модель может токен любой стандартной группы.

| Параметр | Значение |
| - | - |
| ID модели | `MiniMax-H3` (с учётом регистра) |
| Создание задачи | `POST /hailuo/v2/video_generation` |
| Получение задачи | `GET /hailuo/v2/query/video_generation/{task_id}`; при успехе скачайте MP4 по `task.content.url` |
| Группы токенов | `default`, `vip` или `svip` с режимом оплаты «сначала по использованию» (в консоли — 按量优先) |
| Цена | 768P \$0.05/с (на 37.5% ниже официальной), 2K \$0.08/с (на 38% ниже официальной); списывается запрошенная длительность; см. раздел «Цены» |
| Результат | 4–15 целых секунд, `768P` или `2K`, стереозвук в комплекте |
| Хранение | Ссылки на видео доступны 7 дней |
| Маршрут | Работает на открытых весах модели MiniMax H3 в независимом развёртывании, а не через официальный API MiniMax, поэтому тарифицируется отдельно |

> [!WARNING]
>
> MiniMax H3 доступна только через нативные эндпоинты `/hailuo/v2`, указанные выше. Запросы к `/v1/videos` и `/v1/video/generations` отклоняются и не оплачиваются.

![Пример MiniMax H3 «текст в видео»: рыжий кот идёт по мокрой крыше в сумерках, за ним огни города](https://mintcdn.com/laozhangai-edd05f2c/McVdWQYpbAhpR0pV/images/samples/minimax-h3-en-t2v.jpg?fit=max\&auto=format\&n=McVdWQYpbAhpR0pV\&q=85\&s=30be48ac6cea982fc081d900634b5277)

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

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

В разделе [Управление токенами](https://api.laozhang.ai/token) добавьте токен с такими настройками:

| Настройка | Значение |
| - | - |
| Группа | `default`, `vip` или `svip`; цена во всех трёх одинакова |
| Режим оплаты | Сначала по использованию (в консоли — 按量优先, рекомендуется) или оплата по использованию (按量计费); токены с оплатой за вызов (按次计费) эту модель вызвать не могут |
| Совет | Заведите отдельный токен для видео, чтобы сопоставлять списания с задачами в журнале вызовов |

Аккаунт MiniMax и отдельная группа для видео не нужны.

## Цены

MiniMax H3 оплачивается за длину видео. Цены на 24 октября 2026 года:

| Позиция | LaoZhang API | Официальный API MiniMax | Экономия |
| - | -: | -: | -: |
| Выход 768P | \$0.05 / с | \$0.08 / с | 37.5% |
| Выход 2K | \$0.08 / с | \$0.13 / с | 38% |
| Референсное видео | За секунду по тарифу разрешения на выходе | За секунду по тарифу разрешения на выходе | Как у выхода |
| Референсные изображения (первые 5 бесплатно) | \$0.03 за каждое, начиная с 6-го | \$0.04 за каждое, начиная с 6-го | 25% |
| Референсное аудио | Бесплатно | Бесплатно | — |

Официальные цены взяты со страницы [цен MiniMax с оплатой по факту использования](https://platform.minimax.io/docs/guides/pricing-paygo) (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`. Точная сумма по каждой задаче видна в [журнале вызовов](https://api.laozhang.ai/log).

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

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

[Примеры видео Muse](https://docs.laozhang.ai/ru/api-capabilities/muse-video-generation.md) сделаны по тем же промптам, так что модели можно сравнить сцену за сценой.

<video controls preload="none" poster="/images/samples/minimax-h3-sample-fox-768p-6s.jpg" src="https://media.laozhang.ai/samples/video/h3-fox-768p-6s.mp4" />

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

<video controls preload="none" poster="/images/samples/minimax-h3-sample-fox-2k-6s.jpg" src="https://media.laozhang.ai/samples/video/h3-fox-2k-6s.mp4" />

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

<video controls preload="none" poster="/images/samples/minimax-h3-sample-paper-boat-768p-10s.jpg" src="https://media.laozhang.ai/samples/video/h3-paper-boat-768p-10s.mp4" />

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

<video controls preload="none" poster="/images/samples/minimax-h3-sample-hot-air-balloon-768p-10s.jpg" src="https://media.laozhang.ai/samples/video/h3-hot-air-balloon-768p-10s.mp4" />

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

<video controls preload="none" poster="/images/samples/minimax-h3-sample-cyclist-768p-10s-9x16.jpg" src="https://media.laozhang.ai/samples/video/h3-cyclist-768p-10s-9x16.mp4" />

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:

```bash theme={null}
export LAOZHANG_API_KEY="your-laozhang-api-key"
export BASE_URL="https://api.laozhang.ai"
```

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

```bash theme={null}
curl -s -X POST "$BASE_URL/hailuo/v2/video_generation" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{
    "model": "MiniMax-H3",
    "content": [
      {
        "type": "text",
        "text": "At dusk, an orange cat walks slowly across a rain-soaked rooftop as the city lights come on, slow tracking shot, cinematic lighting"
      }
    ],
    "resolution": "768P",
    "duration": 5,
    "ratio": "16:9"
  }' | tee h3-create.json

export TASK_ID=$(jq -r '.task_id' h3-create.json)
```

Успешный запрос возвращает только ID задачи:

```json theme={null}
{
  "task_id": "1792835118519344847"
}
```

Для запросов только с текстом нужно задать конкретное значение `ratio`: `adaptive` без изображения не принимается.

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

Передайте `first_frame`, чтобы задать начальный кадр, и добавьте `last_frame`, чтобы задать и финальный. Если `ratio` равно `adaptive`, соотношение сторон результата повторяет первый кадр:

```bash theme={null}
curl -s -X POST "$BASE_URL/hailuo/v2/video_generation" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{
    "model": "MiniMax-H3",
    "content": [
      { "type": "text", "text": "Собака продолжает бежать по пляжу, камера следует за ней" },
      { "type": "image_url", "role": "first_frame", "image_url": { "url": "https://example.com/start.jpg" } },
      { "type": "image_url", "role": "last_frame", "image_url": { "url": "https://example.com/end.jpg" } }
    ],
    "resolution": "768P",
    "duration": 5,
    "ratio": "adaptive"
  }'
```

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

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

Референсы позволяют поместить в сцену конкретного персонажа или предмет, повторить движение и работу камеры из ролика или подстроиться под ритм аудиодорожки. В промпте ссылайтесь на них по типу и порядку: первое референсное изображение — `<Picture 1>`, первое референсное видео — `<Video 1>`, первое референсное аудио — `<Audio 1>`.

```bash theme={null}
curl -s -X POST "$BASE_URL/hailuo/v2/video_generation" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{
    "model": "MiniMax-H3",
    "content": [
      { "type": "text", "text": "Персонаж из <Picture 1> идёт по парковой дорожке, камера движется как в <Video 1>, а темп следует за <Audio 1>" },
      { "type": "image_url", "role": "reference_image", "image_url": { "url": "https://example.com/character.png" } },
      { "type": "video_url", "role": "reference_video", "video_url": { "url": "https://example.com/camera-move.mp4" } },
      { "type": "audio_url", "role": "reference_audio", "audio_url": { "url": "https://example.com/beat.mp3" } }
    ],
    "resolution": "768P",
    "duration": 5,
    "ratio": "16:9"
  }'
```

Что учесть при сочетании референсов:

* Референсные изображения, видео и аудио можно свободно комбинировать, но аудио не может быть единственным референсом: добавьте хотя бы одно референсное изображение или видео.
* Первый и последний кадры нельзя использовать в одном запросе с референсами.
* Видео и аудио должны быть публичными HTTPS-ссылками, которые сервис может скачать напрямую.
* Референсное видео оплачивается посекундно; см. раздел «Цены».

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

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

```bash theme={null}
curl -s "$BASE_URL/hailuo/v2/query/video_generation/$TASK_ID" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -o h3-task.json
jq -r '.task.status' h3-task.json
```

Повторяйте запрос каждые 10 секунд, пока `task.status` не станет `succeeded` или `failed`. Успешный ответ:

```json theme={null}
{
  "task": {
    "id": "1792835118519344847",
    "model": "MiniMax-H3",
    "status": "succeeded",
    "created_at": 1792835121,
    "updated_at": 1792835146,
    "resolution": "768P",
    "duration": 5,
    "ratio": "16:9",
    "task_type": "generation",
    "modality": "video",
    "usage": {
      "total_seconds": 5,
      "input_seconds": 0,
      "output_seconds": 5,
      "input_image_count": 0
    },
    "content": {
      "url": "https://media.laozhang.ai/videos/1792835118519344847-xxxxxxxxxxxxxxxx.mp4"
    }
  }
}
```

В `usage` указаны оплаченные секунды задачи: `input_seconds` — референсное видео, `output_seconds` — сгенерированное видео.

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

```bash theme={null}
VIDEO_URL=$(jq -r '.task.content.url // empty' h3-task.json)
curl -L -o h3-output.mp4 "$VIDEO_URL"
```

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

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

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

```python theme={null}
import json
import os
import time
import urllib.request
from urllib.error import HTTPError

BASE_URL = "https://api.laozhang.ai"
API_KEY = os.environ["LAOZHANG_API_KEY"]
POLL_INTERVAL = 10  # секунд
TIMEOUT = 30 * 60  # общий таймаут 30 минут


def request(method, path, body=None):
    headers = {"Authorization": f"Bearer {API_KEY}"}
    data = None
    if body is not None:
        headers["Content-Type"] = "application/json"
        data = json.dumps(body).encode("utf-8")
    req = urllib.request.Request(BASE_URL + path, data=data, method=method, headers=headers)
    try:
        with urllib.request.urlopen(req, timeout=60) as resp:
            return json.loads(resp.read().decode("utf-8"))
    except HTTPError as exc:
        error_body = exc.read().decode("utf-8", errors="replace")
        raise RuntimeError(f"HTTP {exc.code}: {error_body}") from exc


created = request(
    "POST",
    "/hailuo/v2/video_generation",
    {
        "model": "MiniMax-H3",
        "content": [{"type": "text", "text": "At dusk, an orange cat walks slowly across a rain-soaked rooftop as the city lights come on"}],
        "resolution": "768P",
        "duration": 5,
        "ratio": "16:9",
    },
)
task_id = created["task_id"]
print("task_id:", task_id)

deadline = time.monotonic() + TIMEOUT
while True:
    task = request("GET", f"/hailuo/v2/query/video_generation/{task_id}")["task"]
    status = task["status"]
    print("status:", status)

    if status == "succeeded":
        # Ссылка для скачивания не требует заголовка Authorization. Передайте User-Agent: некоторые CDN отклоняют стандартный User-Agent Python.
        download = urllib.request.Request(task["content"]["url"], headers={"User-Agent": "h3-client/1.0"})
        with urllib.request.urlopen(download, timeout=300) as resp, open("h3-output.mp4", "wb") as f:
            f.write(resp.read())
        print("Сохранено: h3-output.mp4")
        break
    if status == "failed":
        raise RuntimeError(f"Задача не выполнена (списание возвращено): {json.dumps(task.get('error'))}")
    if time.monotonic() >= deadline:
        raise TimeoutError(f"Задача {task_id} всё ещё выполняется через 30 минут; продолжайте опрашивать тот же task_id")
    time.sleep(POLL_INTERVAL)
```

## Справочник API

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

| Параметр | Значение |
| - | - |
| Базовый URL | `https://api.laozhang.ai` |
| Аутентификация | `Authorization: Bearer $LAOZHANG_API_KEY` |
| Формат запроса | `application/json` |
| Интервал опроса | Рекомендуется 10 секунд |
| Таймаут клиента | Рекомендуется 30 минут |

```text theme={null}
POST https://api.laozhang.ai/hailuo/v2/video_generation
GET  https://api.laozhang.ai/hailuo/v2/query/video_generation/{task_id}
```

### Тело запроса

| Поле | Тип | Обязательно | Описание |
| - | - | - | - |
| `model` | string | Да | Всегда `MiniMax-H3` |
| `content` | array | Да | Ровно один текстовый элемент и необязательные входные данные; см. таблицу ниже |
| `resolution` | string | Да | `768P` или `2K` (заглавными буквами) |
| `duration` | integer | Да | Целое число секунд от 4 до 15; строки и дробные значения отклоняются |
| `ratio` | string | Да | `21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16` или `adaptive` |

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

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

| `type` | `role` | Поле со ссылкой | Ограничение |
| - | - | - | - |
| `text` | — | `text`, до 7 000 символов | 1 элемент |
| `image_url` | `first_frame`, `last_frame` или `reference_image` | `image_url.url` | 9 изображений |
| `video_url` | `reference_video` | `video_url.url` | 3 ролика, всего 15 секунд |
| `audio_url` | `reference_audio` | `audio_url.url` | 3 ролика |

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

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

| `task.status` | Конечный | Что делать |
| - | - | - |
| `queued` | Нет | Ждёт запуска; продолжайте опрос и не отправляйте запрос повторно |
| `running` | Нет | Генерируется; продолжайте опрос |
| `succeeded` | Да | Скачайте MP4 по `task.content.url` |
| `failed` | Да | Прочитайте `task.error.message`; списание возвращено |

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

## Ошибки

| Ответ | Вероятная причина | Что делать |
| - | - | - |
| 400 `分辨率必须为 768P 或 2K。` | `resolution` не равно `768P` или `2K`, либо написано строчными буквами, например `768p` | Используйте `768P` или `2K` |
| 400 `生成时长必须为 4 至 15 秒的整数。` | `duration` вне диапазона, передано строкой или дробным числом | Передайте целое число от 4 до 15 |
| 400 `参考音频不能单独使用` | В запросе только текст и референсное аудио | Добавьте референсное изображение или видео |
| 400 `MiniMax-H3 only supports POST /hailuo/v2/video_generation.` | Запрос отправлен на `/v1/video/generations` | Используйте эндпоинт создания задачи с этой страницы |
| `failed` с `cannot download media URL` | Входную ссылку нельзя скачать из интернета (404, защита от хотлинкинга, приватный адрес) | Отправьте запрос заново с прямой HTTPS-ссылкой на файл |
| 503 `The video service is busy. Please retry later.` | Сервис временно занят, задача не создана | Повторите чуть позже; такой запрос не оплачивается |
| `Current group ... has no available channels for model ...` | Токен не принадлежит `default`, `vip` или `svip`, либо в ID модели неверный регистр | Проверьте группу токена и написание `MiniMax-H3` |
| `... under billing mode [pay-per-request]` | Токен использует режим оплаты за вызов (按次计费) | Переключите токен на «сначала по использованию» (按量优先) или оплату по использованию (按量计费) |

Часть сообщений о проверке параметров приходит на китайском, как показано выше. В рабочей среде сохраняйте `task_id` из ответа на создание и итоговые данные задачи, чтобы сверять списания или обращаться в поддержку ([hi@laozhang.ai](mailto: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 дней. Затем ссылка перестаёт работать, и задачу нельзя скачать повторно, поэтому сохраняйте файл сразу после завершения задачи.

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

* [Сравнение API видео и цены](https://docs.laozhang.ai/ru/api-capabilities/video-generation-guide.md)
* [API видео Wan 2.7 и Wan 3.0](https://docs.laozhang.ai/ru/api-capabilities/wan-video-generation.md)
* [API видео Seedance 2.0](https://docs.laozhang.ai/ru/api-capabilities/seedance2-video-generation.md)
* [Модели и цены](https://docs.laozhang.ai/ru/models.md)
* [Журнал вызовов](https://docs.laozhang.ai/en/faq/call-logs.md)
* [Цены MiniMax с оплатой по факту использования](https://platform.minimax.io/docs/guides/pricing-paygo)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.