Перейти к основному содержанию
POST
/
v1
/
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,
    "metadata": {
      "resolution": "768p",
      "prompt_optimizer": true,
      "fast_pretreatment": false,
      "watermark": false
    }
  }'
{
  "id": "video_01J9HA7JPQ9A0Z6JZ3V8M9W6PZ",
  "object": "generation.task",
  "model": "MiniMax-Hailuo-2.3",
  "status": "queued",
  "progress": 0,
  "created_at": 1768380224,
  "metadata": {}
}
  • Асинхронный режим обработки, возвращает ID задачи для последующих запросов
  • Поддержка текст-в-видео и изображение-в-видео (первый кадр)
  • Поддержка длительности 6 и 10 секунд, разрешения 768p и 1080p
  • 15 типов команд камеры, автооптимизация промпта и управление водяным знаком
Важное изменение: Для улучшения производительности и контроля затрат мы больше не поддерживаем передачу данных изображений в формате base64 непосредственно в параметрах. Пожалуйста, сначала используйте эндпоинт загрузки изображений для загрузки изображений, а затем используйте полученный URL в этом API.

Авторизация

Authorization
string
обязательно
Все эндпоинты требуют аутентификации Bearer TokenПолучить API Key: Перейдите на страницу управления API Key для получения вашего API KeyДобавьте в заголовки запроса:
Authorization: Bearer YOUR_API_KEY

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

model
string
обязательно
Название модели генерации видео, фиксированное значение MiniMax-Hailuo-2.3
prompt
string
обязательно
Описание содержимого видео (максимум 2000 символов)Рекомендуется подробно описывать сцену, действия и стиль. Поддерживаются команды камеры (см. таблицу ниже).Пример: "Милый кот бежит по лугу"
duration
integer
по умолчанию:"6"
Длительность видео (секунды)Варианты:
  • 6 - 6 секунд
  • 10 - 10 секунд
По умолчанию: 6
Ограничение 1080p: При разрешении 1080p поддерживается только длительность 6 секунд.
metadata
object
Специальные параметры расширения

Сочетание разрешения и длительности

РазрешениеПоддерживаемая длительностьПримечание
768p6 с, 10 сВсе варианты
1080p6 с10 с не поддерживается

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

В prompt используйте синтаксис [команда] для управления камерой. Поддерживаются 15 типов:
КатегорияКомандаОписание
Панорама[左移]Панорама влево
Панорама[右移]Панорама вправо
Поворот[左摇]Поворот камеры влево
Поворот[右摇]Поворот камеры вправо
Наезд/отъезд[推进]Наезд (приближение)
Наезд/отъезд[拉远]Отъезд (отдаление)
Подъём/спуск[上升]Подъём камеры
Подъём/спуск[下降]Спуск камеры
Наклон[上摇]Наклон вверх
Наклон[下摇]Наклон вниз
Зум[变焦推近]Зум приближение
Зум[变焦拉远]Зум отдаление
Прочее[晃动]Дрожание камеры
Прочее[跟随]Следование за объектом
Прочее[固定]Фиксированный кадр
Пример использования:
{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "[推进]Кот бежит по саду, камера медленно приближается к крупному плану",
  "duration": 6,
  "metadata": {
    "resolution": "768p"
  }
}

Ответ

id
string
Уникальный идентификатор задачи для запроса статуса
object
string
Тип объекта, фиксированное значение generation.task
model
string
Название использованной модели
status
string
Статус задачи
  • queued - В очереди на обработку
  • in_progress - Обрабатывается
  • completed - Успешно завершено
  • failed - Ошибка
progress
integer
Процент выполнения задачи (0-100)
created_at
integer
Unix-временная метка создания задачи
metadata
object
Метаданные задачи

Примеры использования

Сценарий 1: Быстрая генерация текст-в-видео

{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "Милый кот бежит по лугу, солнечный день",
  "duration": 6,
  "metadata": {
    "resolution": "768p",
    "prompt_optimizer": true,
    "watermark": false
  }
}

Сценарий 2: Высококачественное 1080p видео

{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "Ночной город, неоновые огни, поток машин",
  "duration": 6,
  "metadata": {
    "resolution": "1080p",
    "prompt_optimizer": true,
    "watermark": false
  }
}

Сценарий 3: Изображение-в-видео (первый кадр)

{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "Котёнок бежит к камере, улыбается и моргает",
  "duration": 6,
  "metadata": {
    "first_frame_image": "https://example.com/cat.jpg",
    "resolution": "1080p"
  }
}

Сценарий 4: С командами камеры

{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "[推进]Кот бежит по саду, камера медленно приближается к крупному плану",
  "duration": 6,
  "metadata": {
    "resolution": "768p"
  }
}

Сценарий 5: Режим быстрой предобработки

{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "Волны бьются о берег на закате",
  "duration": 10,
  "metadata": {
    "resolution": "768p",
    "prompt_optimizer": true,
    "fast_pretreatment": true
  }
}
Запрос результатов задачиГенерация видео является асинхронной задачей, после отправки возвращается ID задачи. Используйте конечную точку Получить статус задачи для запроса прогресса и результатов генерации.
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,
    "metadata": {
      "resolution": "768p",
      "prompt_optimizer": true,
      "fast_pretreatment": false,
      "watermark": false
    }
  }'
{
  "id": "video_01J9HA7JPQ9A0Z6JZ3V8M9W6PZ",
  "object": "generation.task",
  "model": "MiniMax-Hailuo-2.3",
  "status": "queued",
  "progress": 0,
  "created_at": 1768380224,
  "metadata": {}
}