MiniMax H3 Max Turbo

MiniMax H3 Max Turbo генерирует короткие видео из текста или изображений кадров. Используйте ID модели minimax-h3-max-turbo, сохраните полученный ID задачи и опрашивайте её до готовности видео. Эта страница описывает собственный интерфейс с массивом content, предлагаемый SeedRouter.

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-turbo",
    "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

Требуется ровно один непустой текстовый элемент. Единственное изображение без роли считается первым кадром. Принимается не более одного первого и одного последнего кадра; последний кадр требует первого. Референсные изображения, видео и аудио не поддерживаются.

Режимы

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

{
  "model": "minimax-h3-max-turbo",
  "content": [
    {"type":"text","text":"Slowly move closer to the ceramic bowl. Keep the glaze and window lighting consistent."},
    {"type":"image_url","image_url":{"url":"https://example.com/first.jpg"},"role":"first_frame"},
    {"type":"image_url","image_url":{"url":"https://example.com/last.jpg"},"role":"last_frame"}
  ],
  "resolution": "480P",
  "duration": 5,
  "ratio": "adaptive",
  "extra": {"prompt_expansion_mode":"balanced"}
}

Изображения кадров

Используйте публичные HTTP(S) URL без встроенных учётных данных. Base64 и ID mm_file:// не принимаются. Изображения могут быть JPG, JPEG, PNG, WebP, HEIC или HEIF, не более 30 МБ каждое, со сторонами 256–5760 пикселей и отношением ширины к высоте от 0,4 до 2,5. Входные данные проверяются до генерации. Для двух кадров используйте согласованные композиции и соотношения сторон.

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

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

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

В разделе цен модели показаны текущие ставки. У Turbo одна составляющая цены: секунды результата в выбранном разрешении. Первый и последний кадры, а также расширение промпта не оплачиваются отдельно.

cost = reported output seconds × output-second rate for the resolution

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

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

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

{"id": "task_...", "model": "minimax-h3-max-turbo", "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-turbo",
  "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-turbo",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "the request was blocked by content moderation"
  }
}

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

Советы

• Описывайте один объект, действие, движение камеры и схему освещения на каждый план.
• Используйте 480P для черновика и 768P для большей детализации результата. Каждая новая генерация — отдельный платный запрос.
• Передайте первый кадр, чтобы задать начальную композицию; добавляйте последний кадр только вместе с первым.
• Используйте extra.prompt_expansion_mode для выбора disabled, balanced или quality; при пропуске сохраняется balanced.
• Перед публикацией проверьте весь ролик и его звук. Промпт не гарантирует точной геометрии товара или надписей.

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

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

Область действия контракта

Этот интерфейс использует формат запросов MiniMax с массивом content, ID моделей SeedRouter, асинхронные задачи, изображения только по URL и доставку размещённого результата. Обратные вызовы и отмена недоступны. content_filter — проверка входных данных SeedRouter, а не параметр MiniMax.

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