Skip to main content
POST
Выбор модели: используйте MiniMax-H3-Max, если важна скорость и достаточно генерации из текста либо управления первым/последним кадром. Для 2K, промежуточных кадров, референсных изображений, видео или аудио используйте MiniMax-H3.

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

string
обязательно
Для всех эндпоинтов нужен Bearer Token. Получите ключ на странице API-ключей.

Выбор модели

MiniMax-H3-Max не поддерживает 2K, а его результат нельзя использовать как источник для Regeneration.

Режимы генерации

Режим определяется полями запроса автоматически; не передавайте поле mode.
Модель не поддерживает image_urls, video_urls, audio_urls и image_with_roles[].role = "reference_image". Любой референсный материал синхронно возвращает HTTP 400 до создания задачи и списания средств.

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

string
обязательно
Фиксированное значение: MiniMax-H3-Max. Регистр не учитывается; minimax-h3-max также допустимо.
string
обязательно
Непустое описание видео, обязательное во всех режимах. Максимум 7000 символов.
integer
по умолчанию:"5"
Длительность видео в секундах: целое число от 5 до 15, по умолчанию 5. Четыре секунды не поддерживаются.
string
по умолчанию:"768P"
Разрешение: 768P (по умолчанию) или 480P.
2K, 1440P и 2048P не поддерживаются. Недопустимое значение возвращает HTTP 400 без автоматического понижения разрешения.
string
Соотношение сторон. Также принимаются псевдонимы size и ratio.Значения T2V: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16.
  • T2V без поля или с adaptive: используется 16:9
  • I2V: определяется входным изображением; поле игнорируется
string
Публичный URL изображения для первого кадра.
string
Публичный URL изображения для последнего кадра. Можно использовать отдельно или вместе с first_frame_image.
object[]
Массив изображений с ролями вместо first_frame_image и last_frame_image.Для каждой роли допускается не более одного изображения; role не может быть пустым.
boolean
по умолчанию:"false"
Добавить водяной знак AIGC. Псевдоним: aigc_watermark.
string
Получает уведомление при успешном или неуспешном завершении задачи.
Используйте webhook, а не callback_url MiniMax. Поле callback_url зарезервировано шлюзом.

Неподдерживаемые параметры

Следующие значения возвращают HTTP 400 до создания задачи и тарификации:
Для референсов, 2K, промежуточных кадров или 4-секундного видео используйте MiniMax-H3.

Ограничения изображений

Общий размер тела запроса — не более 64 МБ. Используйте публичные URL; Base64 не поддерживается.

Примеры

Первый кадр

Первый и последний кадры

Проверка задачи

После отправки возвращается task_id. Проверяйте статус задачи каждые 5–10 секунд; рекомендуемый клиентский тайм-аут — 15 минут.
URL созданного видео обычно истекает примерно через 24 часа. Сохраните результат своевременно.

Тарифы

Итоговая стоимость = цена за секунду × длительность. Первый и последний кадры бесплатны. При отправке резервируется расчётная сумма. Неуспешные задачи полностью возмещаются; окончательным является поле cost в ответе задачи.

Ошибки

Ошибка генерации возвращает status = failed и error.message; средства возвращаются автоматически.

Response

integer
Код ответа; при успехе 200
array
Результат отправки с начальным статусом и ID задачи