Генерация видео MiniMax-Hailuo-2.3

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax-Hailuo-2.3",
    "prompt": "Кот бежит по саду, камера медленно приближается, кинематографичное качество",
    "duration": 6,
    "resolution": "1080P"
  }'

import requests

response = requests.post(
    "https://toapis.com/v1/videos/generations",
    headers={
        "Authorization": "Bearer your-ToAPIs-key",
        "Content-Type": "application/json",
    },
    json={
        "model": "MiniMax-Hailuo-2.3",
        "prompt": "Кот бежит по саду, камера медленно приближается, кинематографичное качество",
        "duration": 6,
        "resolution": "1080P",
    },
)

print(response.json())

const response = await fetch("https://toapis.com/v1/videos/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer your-ToAPIs-key",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "MiniMax-Hailuo-2.3",
    prompt: "Кот бежит по саду, камера медленно приближается, кинематографичное качество",
    duration: 6,
    resolution: "1080P"
  })
});

console.log(await response.json());

{
  "id": "vid_01J9HA7JPQ9A0Z6JZ3V8M9W6PZ",
  "object": "generation.task",
  "model": "MiniMax-Hailuo-2.3",
  "status": "queued",
  "progress": 0,
  "created_at": 1768380224,
  "metadata": {}
}

POST

videos

generations

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax-Hailuo-2.3",
    "prompt": "Кот бежит по саду, камера медленно приближается, кинематографичное качество",
    "duration": 6,
    "resolution": "1080P"
  }'

import requests

response = requests.post(
    "https://toapis.com/v1/videos/generations",
    headers={
        "Authorization": "Bearer your-ToAPIs-key",
        "Content-Type": "application/json",
    },
    json={
        "model": "MiniMax-Hailuo-2.3",
        "prompt": "Кот бежит по саду, камера медленно приближается, кинематографичное качество",
        "duration": 6,
        "resolution": "1080P",
    },
)

print(response.json())

const response = await fetch("https://toapis.com/v1/videos/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer your-ToAPIs-key",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "MiniMax-Hailuo-2.3",
    prompt: "Кот бежит по саду, камера медленно приближается, кинематографичное качество",
    duration: 6,
    resolution: "1080P"
  })
});

console.log(await response.json());

{
  "id": "vid_01J9HA7JPQ9A0Z6JZ3V8M9W6PZ",
  "object": "generation.task",
  "model": "MiniMax-Hailuo-2.3",
  "status": "queued",
  "progress": 0,
  "created_at": 1768380224,
  "metadata": {}
}

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

Асинхронный режим, возвращает ID задачи
Поддерживаемые модели: MiniMax-Hailuo-2.3, MiniMax-Hailuo-2.3-Fast
MiniMax-Hailuo-2.3: поддержка текст-в-видео и изображение-в-видео, максимальное качество
MiniMax-Hailuo-2.3-Fast: только изображение-в-видео (обязательно передать первый кадр), ускоренная генерация

Используйте публично доступные URL изображений. Не передавайте base64 данные в image_urls; для локальных изображений сначала используйте API загрузки изображений для получения URL.

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

string

обязательно

Все эндпоинты требуют аутентификации Bearer Token.

Authorization: Bearer YOUR_API_KEY

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

string

обязательно

Название модели.Доступные значения:

MiniMax-Hailuo-2.3 - поддержка текст-в-видео и изображение-в-видео
MiniMax-Hailuo-2.3-Fast - только изображение-в-видео (обязательно передать image_urls)

string

обязательно

Описание содержимого видео, максимум 2000 символов.Поддерживается 15 типов команд камеры (например [推进], [拉远], [左摇,上升]), см. таблицу ниже.Пример:

"Кот бежит по саду [推进], затем останавливается и смотрит в камеру [固定]"

integer

по умолчанию:"6"

Длительность видео (секунды).Доступные значения: 6 или 10

При разрешении 1080P поддерживается только длительность 6 секунд.

string

по умолчанию:"768P"

Разрешение видео.Доступные значения:

768P - HD (по умолчанию)
1080P - Full HD (только 6 секунд)

string[]

Массив URL изображений первого кадра.

Не передавать: текст-в-видео (MiniMax-Hailuo-2.3-Fast не поддерживает, обязательно передать)
1 изображение: изображение-в-видео, изображение используется как первый кадр

Требования к изображению:

Формат: JPG, JPEG, PNG, WebP
Размер: до 20MB
Разрешение: короткая сторона > 300px, соотношение сторон от 2:5 до 5:2

Пример: ["https://example.com/first-frame.jpg"]

object

Расширенные параметры.

Показать Показать поля metadata

boolean

по умолчанию:"true"

Автоматическая оптимизация промпта. Установите false для более точного контроля.

boolean

по умолчанию:"false"

Сократить время оптимизации промпта. Ускоряет обработку при включении.

boolean

по умолчанию:"false"

Добавить водяной знак к сгенерированному видео.

string

Финальный Task Webhook ToAPIs. Сначала настройте URL и secret Token; см. Webhook.

Сравнение моделей

Модель	Текст-в-видео	Изображение-в-видео	Разрешение	Длительность
`MiniMax-Hailuo-2.3`	✅	✅	`768P` / `1080P`	6с / 10с
`MiniMax-Hailuo-2.3-Fast`	❌	✅ (обязателен первый кадр)	`768P` / `1080P`	6с / 10с

Комбинации разрешения и длительности

Разрешение	Поддерживаемая длительность	Примечание
768P	6 с, 10 с	По умолчанию
1080P	6 с	10 с не поддерживается

Команды камеры

В prompt используйте синтаксис [команда] для управления камерой:

Категория	Команды
Панорама	`[左移]` `[右移]`
Поворот	`[左摇]` `[右摇]`
Наезд/отъезд	`[推进]` `[拉远]`
Подъём/спуск	`[上升]` `[下降]`
Наклон	`[上摇]` `[下摇]`
Зум	`[变焦推近]` `[变焦拉远]`
Прочее	`[晃动]` `[跟随]` `[固定]`

Правила использования:

Комбинация: несколько команд в одних [] действуют одновременно, например [左摇,上升], рекомендуется не более 3
Последовательность: команды в разных позициях промпта действуют по порядку, например "...[推进], затем...[拉远]"

Ответ

string

ID задачи для запроса статуса.

string

Тип объекта, всегда generation.task.

string

Использованная модель.

string

Статус задачи: queued, in_progress, completed или failed.

integer

Временная метка создания задачи.

Примеры

Текст-в-видео

{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "Кот бежит по саду, камера медленно приближается, кинематографичное качество",
  "duration": 6,
  "resolution": "1080P"
}

Изображение-в-видео

{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "Человек на изображении медленно поворачивается и улыбается",
  "image_urls": ["https://example.com/portrait.jpg"],
  "duration": 6,
  "resolution": "1080P"
}

Изображение-в-видео (режим Fast)

{
  "model": "MiniMax-Hailuo-2.3-Fast",
  "prompt": "Человек начинает медленно идти",
  "image_urls": ["https://example.com/person.jpg"],
  "duration": 6,
  "resolution": "768P"
}

Управление камерой

{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "Человек берёт книгу [上升], затем начинает читать [固定]",
  "duration": 6,
  "resolution": "768P"
}

10-секундное видео

{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "Волны бьются о берег на закате, золотистый свет на воде",
  "duration": 10,
  "resolution": "768P",
  "metadata": {
    "prompt_optimizer": true,
    "fast_pretreatment": true
  }
}

Генерация видео — асинхронная задача. После отправки используйте Получить статус задачи для запроса прогресса и результатов.

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax-Hailuo-2.3",
    "prompt": "Кот бежит по саду, камера медленно приближается, кинематографичное качество",
    "duration": 6,
    "resolution": "1080P"
  }'

import requests

response = requests.post(
    "https://toapis.com/v1/videos/generations",
    headers={
        "Authorization": "Bearer your-ToAPIs-key",
        "Content-Type": "application/json",
    },
    json={
        "model": "MiniMax-Hailuo-2.3",
        "prompt": "Кот бежит по саду, камера медленно приближается, кинематографичное качество",
        "duration": 6,
        "resolution": "1080P",
    },
)

print(response.json())

const response = await fetch("https://toapis.com/v1/videos/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer your-ToAPIs-key",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "MiniMax-Hailuo-2.3",
    prompt: "Кот бежит по саду, камера медленно приближается, кинематографичное качество",
    duration: 6,
    resolution: "1080P"
  })
});

console.log(await response.json());

{
  "id": "vid_01J9HA7JPQ9A0Z6JZ3V8M9W6PZ",
  "object": "generation.task",
  "model": "MiniMax-Hailuo-2.3",
  "status": "queued",
  "progress": 0,
  "created_at": 1768380224,
  "metadata": {}
}

Обзор

Быстрый старт

API чата

API изображений

API видео

Управление задачами

Загрузка файлов

Аккаунт

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

Генерация видео MiniMax-Hailuo-2.3

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

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

Сравнение моделей

Комбинации разрешения и длительности

Команды камеры

Ответ

Примеры

Текст-в-видео

Изображение-в-видео

Изображение-в-видео (режим Fast)

Управление камерой

10-секундное видео

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

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

​Сравнение моделей

​Комбинации разрешения и длительности

​Команды камеры

​Ответ

​Примеры

​Текст-в-видео

​Изображение-в-видео

​Изображение-в-видео (режим Fast)

​Управление камерой

​10-секундное видео

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

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

Сравнение моделей

Комбинации разрешения и длительности

Команды камеры

Ответ

Примеры

Текст-в-видео

Изображение-в-видео

Изображение-в-видео (режим Fast)

Управление камерой

10-секундное видео