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

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

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

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

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

Ограничения параметров

ОграничениеОписание
ДлительностьПоддерживает только 5 или 10 секунд
Разрешение 1080pПоддерживает только 5-секундную длительность
Формат изображенияТолько формат URL (base64 больше не поддерживается)

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

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

Ответ

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-02",
  "prompt": "Милый котенок бежит по траве, солнечный день"
}

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

{
  "model": "MiniMax-Hailuo-02",
  "prompt": "Ночная городская сцена, мерцающие неоновые огни, поток транспорта",
  "duration": 5,
  "metadata": {
    "resolution": "1080p",
    "prompt_optimizer": true,
    "watermark": false
  }
}

Сценарий 3: Генерация видео на основе первого кадра

{
  "model": "MiniMax-Hailuo-02",
  "prompt": "Человек медленно поворачивается, улыбается",
  "duration": 5,
  "metadata": {
    "resolution": "768p",
    "first_frame_image": "https://example.com/portrait.jpg"
  }
}

Сценарий 4: Переходное видео с контролем первого и последнего кадра

{
  "model": "MiniMax-Hailuo-02",
  "prompt": "Сцена постепенно переходит от дня к ночи, градиент неба",
  "duration": 10,
  "metadata": {
    "resolution": "768p",
    "first_frame_image": "https://example.com/day.jpg",
    "last_frame_image": "https://example.com/night.jpg",
    "prompt_optimizer": true
  }
}

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

{
  "model": "MiniMax-Hailuo-02",
  "prompt": "Волны бьются о пляж, время заката",
  "duration": 5,
  "metadata": {
    "resolution": "768p",
    "prompt_optimizer": true,
    "fast_pretreatment": true
  }
}
Запрос результатов задачиГенерация видео - асинхронная задача. После отправки возвращается task_id. Используйте интерфейс Получить статус задачи для запроса прогресса генерации и результатов.
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax-Hailuo-02",
    "prompt": "Милый котенок бежит по траве",
    "duration": 5,
    "metadata": {
      "resolution": "768p",
      "prompt_optimizer": true,
      "fast_pretreatment": false,
      "watermark": false
    }
  }'
{
  "id": "video_01K8SGYNNNVBQTXNR4MM964S7K",
  "object": "generation.task",
  "model": "MiniMax-Hailuo-02",
  "status": "queued",
  "progress": 0,
  "created_at": 1768380224,
  "metadata": {
    "resolution": "768p"
  }
}