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

# Генерация видео MiniMax Hailuo H3

> Генерация видео MiniMax Hailuo H3 в 2K или 768p по тексту, первому/последнему кадру и мультимодальным референсам

> [!NOTE]
>
> **Для пользователей из материкового Китая:** используйте `https://toapis.cn` в качестве эндпоинта (Base URL). Замените `https://toapis.com` на `https://toapis.cn` во всех примерах этого документа.

* Поддерживаются три модели: `MiniMax-H3`, `MiniMax-H3-Max` и `MiniMax-H3-Max-Turbo`
* `MiniMax-H3` и `MiniMax-H3-Max` поддерживают текст-в-видео, первый/последний кадр и совместные референсы изображений, видео и аудио
* `MiniMax-H3-Max-Turbo` поддерживает только текст-в-видео и первый/последний кадр, без референсных медиа
* Для старого H3 сохраняются `2K` / `768p` и `4-15` секунд. Max / Max-Turbo поддерживают `480P` / `768P` и `5-15` секунд
* Асинхронный API возвращает унифицированный объект `generation.task`

> [!WARNING]
>
> `MiniMax-H3-Max-Turbo` не поддерживает `reference_image`, `reference_video` и `reference_audio`. При отправке референсных медиа возвращается ошибка `MiniMax-H3-Max-Turbo does not support reference media`. Для референсных видео используйте `MiniMax-H3` или `MiniMax-H3-Max`.

> [!WARNING]
>
> Используйте публично доступные URL. Режим кадров нельзя смешивать с режимом референсов. Референсное аудио нельзя использовать без хотя бы одного изображения или видео.

## Аутентификация

**Authorization** `string` *required*

Передайте `Authorization: Bearer YOUR_API_KEY`.

## Параметры запроса

**model** `string` *required* (default: MiniMax-H3)

Выберите `MiniMax-H3`, `MiniMax-H3-Max` или `MiniMax-H3-Max-Turbo`. Мультимодальные референсы поддерживают только `MiniMax-H3` и `MiniMax-H3-Max`; Turbo поддерживает только текст-в-видео и первый/последний кадр.

**prompt** `string` *required*

Описание видео, до `7000` символов.

**duration** `integer` (default: 5)

`MiniMax-H3`: целое число от `4` до `15` секунд; Max / Max-Turbo: от `5` до `15` секунд.

**resolution** `string` (default: 2K)

`MiniMax-H3` поддерживает `2K` и `768p`; Max / Max-Turbo поддерживают `480P` и `768P`.

**aspect\_ratio** `string` (default: 16:9)

Значения: `21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `adaptive`.
Для текст-в-видео нельзя использовать `adaptive`. Режим кадров автоматически следует входному изображению, а режим референсов по умолчанию использует `adaptive`.
Режим референсов доступен только для `MiniMax-H3` и `MiniMax-H3-Max`.

**image\_urls** `string[]`

Совместимый массив URL: 1 изображение становится первым кадром, 2 — первым и последним, 3-9 — референсами. Для новых интеграций используйте `image_with_roles`.
Ввод 3-9 референсных изображений поддерживают только `MiniMax-H3` и `MiniMax-H3-Max`; Turbo его не поддерживает.

**image\_with\_roles** `array`

Массив объектов `url` и `role`. Роли: `first_frame` (не более 1), `last_frame` (не более 1), `reference_image` (не более 9).
`reference_image` поддерживают только `MiniMax-H3` и `MiniMax-H3-Max`; Turbo поддерживает только `first_frame` и `last_frame`.
Форматы JPG, JPEG, PNG, WebP, HEIC, HEIF; до `30 MB`, стороны `256-5760 px`, соотношение `0.4-2.5`.

**video\_with\_roles** `array`

Поддерживается только моделями `MiniMax-H3` и `MiniMax-H3-Max`, но не Turbo.
До `3` референсных видео. Каждый объект содержит `url` и `role: reference_video`. MP4/MOV, до `50 MB`, `2-15` секунд каждое и не более `15` секунд суммарно.
\[!NOTE] ToAPIs определяет фактическую длительность для тарификации. Не передавайте рассчитанное клиентом поле длительности.

**audio\_with\_roles** `array`

Поддерживается только моделями `MiniMax-H3` и `MiniMax-H3-Max`, но не Turbo.
До `3` референсных аудио. Каждый объект содержит `url` и `role: reference_audio`. WAV/MP3, до `15 MB`, `2-15` секунд каждое и не более `15` секунд суммарно.
\[!WARNING] Нужно добавить хотя бы одно референсное изображение или видео.

**watermark** `boolean` (default: false)

Добавить водяной знак AIGC.

**client\_business\_id** `string`

Клиентский бизнес-ID, например номер заказа.

**callback\_url** `string`

Callback завершения задачи ToAPIs. См. [Webhook](https://docs.toapis.com/docs/ru/api-reference/webhooks/task-webhooks.md).

## Режимы и ограничения

| Режим | Поддерживаемые модели | Вход | Соотношение |
| - | - | - | - |
| Текст-в-видео | Все три модели | `prompt` | Конкретное, по умолчанию `16:9` |
| Первый/последний кадр | Все три модели | `prompt` + кадры | Автоматически `adaptive` |
| Мультимодальные референсы | Только `MiniMax-H3` и `MiniMax-H3-Max` | `prompt` + медиа | По умолчанию `adaptive` |

Следующие ограничения референсных медиа относятся только к `MiniMax-H3` и `MiniMax-H3-Max`.

Допускается до 9 изображений, 3 видео, 3 аудио и 12 медиафайлов суммарно. Роли кадров и референсов нельзя смешивать.

## Пример

В примерах с референсными медиа используется `MiniMax-H3`. Простая замена `model` на `MiniMax-H3-Max-Turbo` не поддерживается. Для `MiniMax-H3-Max` задайте `resolution` как `480P` или `768P`, а `duration` от `5` до `15` секунд.

```json theme={null}
{
  "model": "MiniMax-H3",
  "prompt": "Следовать движениям и ритму камеры из видео 1, произнести реплику голосом из аудио 1",
  "duration": 5,
  "resolution": "768p",
  "aspect_ratio": "adaptive",
  "video_with_roles": [
    {"url": "https://example.com/motion.mp4", "role": "reference_video"}
  ],
  "audio_with_roles": [
    {"url": "https://example.com/voice.mp3", "role": "reference_audio"}
  ]
}
```

## Ответ

**id** `string`

ID задачи ToAPIs.

**object** `string`

Всегда `generation.task`.

**model** `string`

Всегда `MiniMax-H3`.

**status** `string`

`queued`, `in_progress`, `completed` или `failed`.

**progress** `integer`

Прогресс `0-100`.

**created\_at** `integer`

Unix-время создания в секундах.

> [!NOTE]
>
> Опрашивайте [статус видеозадачи](https://docs.toapis.com/docs/ru/api-reference/tasks/video-status.md). После завершения URL находится в `result.data[0].url`.

```bash cURL (текст-в-видео) theme={null}
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{"model":"MiniMax-H3","prompt":"Камера медленно приближается к астронавту на поверхности Луны","duration":5,"resolution":"2K","aspect_ratio":"16:9"}'
```

```bash cURL (референсы изображения, видео и аудио) theme={null}
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax-H3",
    "prompt": "Сохранить персонажа из изображения 1, следовать движению камеры из видео 1 и использовать голос из аудио 1",
    "duration": 5,
    "resolution": "2K",
    "aspect_ratio": "adaptive",
    "image_with_roles": [{"url": "https://example.com/person.png", "role": "reference_image"}],
    "video_with_roles": [{"url": "https://example.com/motion.mp4", "role": "reference_video"}],
    "audio_with_roles": [{"url": "https://example.com/voice.mp3", "role": "reference_audio"}]
  }'
```

```json 200 theme={null}
{"id":"vid_01KZ3H3EXAMPLE00000000000","object":"generation.task","model":"MiniMax-H3","status":"queued","progress":0,"created_at":1785729000}
```


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