MiniMax-H3
Генерация видео MiniMax-H3-Max
- Быстрая версия MiniMax Video Generation V2 с асинхронной постановкой задачи
- Поддерживает генерацию из текста и изображения с первым, последним или обоими кадрами
- Поддерживает 768P / 480P, длительность 5–15 секунд и звуковую дорожку
- Не поддерживает 2K, промежуточные кадры и мультимодальные референсы
POST
Выбор модели: используйте
MiniMax-H3-Max, если важна скорость и достаточно генерации из текста либо управления первым/последним кадром. Для 2K, промежуточных кадров, референсных изображений, видео или аудио используйте MiniMax-H3.Аутентификация
string
обязательно
Для всех эндпоинтов нужен Bearer Token. Получите ключ на странице API-ключей.
Выбор модели
Режимы генерации
Режим определяется полями запроса автоматически; не передавайте полеmode.
Параметры запроса
string
обязательно
Фиксированное значение:
MiniMax-H3-Max. Регистр не учитывается; minimax-h3-max также допустимо.string
обязательно
Непустое описание видео, обязательное во всех режимах. Максимум
7000 символов.integer
по умолчанию:"5"
Длительность видео в секундах: целое число от
5 до 15, по умолчанию 5. Четыре секунды не поддерживаются.string
по умолчанию:"768P"
Разрешение:
768P (по умолчанию) или 480P.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 до создания задачи и тарификации:Ограничения изображений
Общий размер тела запроса — не более 64 МБ. Используйте публичные URL; Base64 не поддерживается.Примеры
Первый кадр
Первый и последний кадры
Проверка задачи
После отправки возвращаетсяtask_id. Проверяйте статус задачи каждые 5–10 секунд; рекомендуемый клиентский тайм-аут — 15 минут.
URL созданного видео обычно истекает примерно через 24 часа. Сохраните результат своевременно.
Тарифы
Итоговая стоимость = цена за секунду × длительность. Первый и последний кадры бесплатны.
При отправке резервируется расчётная сумма. Неуспешные задачи полностью возмещаются; окончательным является поле
cost в ответе задачи.
Ошибки
Ошибка генерации возвращает
status = failed и error.message; средства возвращаются автоматически.
Response
integer
Код ответа; при успехе 200
array
Результат отправки с начальным статусом и ID задачи