MiniMax H3 Max

MiniMax H3 Max — вариант MiniMax H3 с более быстрой генерацией. Один запрос создаёт изображение и звук вместе: ролик на 5–15 секунд в 480P или 768P со своими диалогами, атмосферой и эффектами. Тело запроса имеет официальный формат MiniMax с ID модели minimax-h3-max. Отправьте его, сохраните полученный ID задачи и получите готовое видео из задачи. Кадры и референсы передаются как URL.

ID моделей

Текущие цены приведены на странице модели.

Краткий пример

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3-max",
    "content": [
      {"type": "text", "text": "A small sailboat glides across a calm turquoise bay at sunrise, seagulls in the distance, the sound of water and wind. No text, no logos."}
    ],
    "resolution": "768P",
    "duration": 5,
    "ratio": "16:9"
  }'

Эндпоинт

POST https://api.seedrouter.ai/v1/videos/generations

Ответ содержит задачу ({"id": "task_...", "status": "processing"}), а не готовое видео. Опрашивайте GET /v1/tasks/{task_id} для получения результата. Храните API-ключи в серверном коде.

Параметры

Схема строгая: неизвестные поля отклоняются, а не игнорируются. callback_url недоступен; вместо него опрашивайте задачу. extra — необязательный строгий объект, содержащий только prompt_expansion_mode. Все поля отклоняют null; необязательные поля вместо этого опускайте.

Элементы content

Единственное изображение без role считается первым кадром. При нескольких изображениях каждому нужен role.

Режимы

Режим определяется элементами content; отдельного поля режима нет.

Кадры и референсы нельзя объединять в одном запросе. Официальная документация перечисляет ввод только последнего кадра, но также содержит противоречащее ему требование добавить первый кадр. Этот случай не проверен в SeedRouter. Если нужно финальное изображение, используйте оба кадра.

{
  "model": "minimax-h3-max",
  "content": [
    {"type": "text", "text": "The person in the photo speaks to camera: Follow the wind. Voice follows the reference audio."},
    {"type": "image_url", "image_url": {"url": "https://example.com/person.jpg"}, "role": "reference_image"},
    {"type": "audio_url", "audio_url": {"url": "https://example.com/voice.mp3"}, "role": "reference_audio"}
  ],
  "resolution": "768P",
  "duration": 6
}

Входные медиа

Каждый элемент изображения, видео и аудио — публичный HTTP(S) URL. Base64 data URI и ID mm_file:// не принимаются: загрузите файл в своё хранилище и передайте его URL.

Длительность референсного видео измеряется при принятии запроса; если её нельзя прочитать, запрос отклоняется без оплаты. Остальные ограничения проверяются перед генерацией; нарушающий их запрос завершается ошибкой без списания.

Фильтр контента

content_filter равен true, если вы не задали иное. При включённом фильтре запрос, его текст и медиа проходят модерацию до генерации. Помеченный запрос завершается ошибкой с кодом 60001 и не оплачивается. Задайте content_filter: false, чтобы пропустить модерацию; на сайте Playground всегда оставляет её включённой.

Составляющие цены

Проверьте текущие ставки в разделе цен модели. MiniMax H3 Max отдельно тарифицирует секунды результата и референсного видео по разрешению результата. Первые два изображения бесплатны; каждое последующее увеличивает стоимость.

output seconds = reported generated seconds
input seconds  = reported reference-video seconds
extra images   = max(0, reported input image count − 2)
cost = output seconds × output rate
     + input seconds × reference-video rate
     + extra images × image rate

Для итогового учёта длительности референсных видео складываются и округляются до ближайшей целой секунды. Поэтому два ролика по 2,4 секунды дают пять входных секунд. Референсное аудио не оплачивается как вход. Первый и последний кадры считаются изображениями, поэтому два кадра сами по себе не добавляют платы за изображения.

Оценка Playground округляет длительности референсных видео вверх, чтобы покрыть возможную итоговую стоимость. Итоговое использование тарифицируется по ставке, зафиксированной для запроса. Если полный отчёт об использовании недоступен, применяется принятая оценка. Списания смотрите в истории использования аккаунта; публичные ответы задач не содержат стоимости. Неудачные задачи не оплачиваются.

Схема результата

При отправке возвращается задача:

{"id": "task_...", "model": "minimax-h3-max", "status": "processing", "created_at": 1789689600}

Получить задачу

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Опрашивайте каждые 10–20 секунд, пока status не станет completed или failed. Сетевой тайм-аут при опросе не означает сбой генерации: сохраните ID задачи и возобновите проверку. Не создавайте новую задачу для проверки прогресса.

Завершённая задача

{
  "id": "task_...",
  "model": "minimax-h3-max",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689740,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4",
    "resolution": "768P",
    "ratio": "16:9",
    "duration": 5
  }
}

ratio — соотношение сторон созданного ролика, включая выбранное для adaptive. Задача содержит фактические разрешение, соотношение сторон и длительность, если они сообщены. JSON выше показывает структуру ответа; это не измеренный результат генерации.

Ошибки

Запросы, отклонённые до создания задачи, возвращают HTTP-ошибку с объектом error и не оплачиваются. Задача, завершившаяся ошибкой после принятия, при запросе возвращает HTTP 200 со status: "failed" и объектом error.

Коды, HTTP-статусы и рекомендации по повторам приведены в общем каталоге ошибок.

{
  "id": "task_...",
  "model": "minimax-h3-max",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "the request was blocked by content moderation"
  }
}

Если тайм-аут произошёл при самой отправке, проверьте свои задачи перед повторной отправкой: первый запрос мог быть принят.

Советы

• Описывайте план и его звук вместе: объект, место, камеру, свет, диалоги и эффекты.
• Включайте диалоги в промпт и прикрепляйте референсное аудио, если голос должен ему следовать.
• Сделайте черновик в 480P, затем выберите 768P, если нужна большая детализация. Новый рендер — отдельный платный запрос.
• Используйте extra: {"prompt_expansion_mode": "disabled"} для уже полного промпта либо выберите расширение balanced / quality.
• Используйте первый и последний кадры для управления началом и концом плана; референсы — для сохранения товара, человека или движения.
• Добавьте no text, no logos, чтобы избежать выдуманных надписей и знаков.

Связанные материалы

• Playground и цены MiniMax H3 Max
• Скачать OpenAPI
• Markdown для копирования

Источники контракта

Параметры соответствуют документации генерации видео MiniMax. SeedRouter использует собственный ID модели и асинхронный интерфейс задач, медиа только по URL и доставку размещённого результата; обратные вызовы и отмена недоступны. content_filter — расширение SeedRouter.