Claude Opus 5.5 уже доступна в SeedRouter

Video

MiniMax H3

View Markdown

Генерируйте с MiniMax H3 ролики на 4–15 секунд со звуком в 768P или 2K: текст в видео, первый и последний кадр и референсы в видео, в официальном формате запроса MiniMax, с выдачей через задачу.

Standard и Pro

Оба канала поддерживают content_filter. По умолчанию используется true: содержимое проверяется перед генерацией. В Playground проверка остаётся включённой; пользователи API могут задать false. Ограничения контента со стороны поставщика могут по-прежнему действовать.

minimax-h3 — это Pro с прежним форматом запроса и поведением. Следующие разделы о нативном формате описывают Pro. Standard использует minimax-h3-standard со своим плоским телом JSON на том же эндпоинте /v1/videos/generations. Это не версия Max или Turbo. Автоматическое переключение между двумя вариантами не выполняется.

{
  "model": "minimax-h3-standard",
  "prompt": "A sailboat crosses a quiet bay, with soft wind and waves.",
  "quality": "high",
  "content_filter": true,
  "duration_s": 5,
  "resolution": "768p",
  "aspect_ratio": "16:9"
}

Standard принимает только перечисленные поля. URL должны быть общедоступными адресами HTTP(S) без учётных данных; прямая загрузка файлов и base64 не принимаются.

ПолеТипОбязательность / по умолчаниюЗначения
modelstringобязательноminimax-h3-standard
promptstringобязательнонепустое; обязательно в каждом режиме
qualitystringобязательноlow, high; одинаковая цена
duration_snumber55–15, включая дробные значения
resolutionstring768p480p, 768p, 1080p, 2k, 4k
aspect_ratiostring16:916:9, 9:16, 1:1, 4:3, 3:4, 21:9
seedintegerслучайный0–9223372036854775807
watermarkbooleanfalsetrue / false
enhancebooleantrueпереформулировка промпта; false сохраняет промпт
priorityinteger10001000 / 0
content_filterbooleantrueПроверка содержимого SeedRouter перед генерацией; false пропускает проверку
first_frame_image_urlstringнеобязательноодин URL изображения
last_frame_image_urlstringнеобязательнотребуется первый кадр
reference_image_urlstring[]необязательно1–4 URL изображений
reference_video_urlstring[]необязательноодин URL видео

Первый и последний кадры нельзя совмещать с референсами. Без медиа видео создаётся по тексту. Референсные изображения и одно референсное видео можно совмещать. Отдельное референсное аудио не поддерживается. Каждый результат содержит встроенное аудио. Low ориентирован на скорость, High — на точность воспроизведения, но ни для одного из них не заявлено соответствие качеству Pro.

Изображения: до 30 MiB каждое; JPEG, PNG, WebP, GIF, BMP, TIFF, HEIC, HEIF или AVIF. Ограничений на размеры изображений нет; большие изображения могут быть уменьшены перед генерацией. Видео: до 100 MiB, 0.5–600 секунд, читаемый видеопоток (включая MP4, MOV и WebM), чётные ширина и высота не менее 64 пикселей каждая.

Стоимость Standard: ceil(duration_s) × текущий тариф для разрешения. Референсные медиа, аудио, качество и переформулировка промпта не оплачиваются дополнительно. Неудачные задачи не оплачиваются. Цены берутся из раздела актуальных цен.

Создание и опрос используют общий асинхронный протокол ниже. Успешный результат содержит video_url, resolution, ratio и duration; duration соответствует запрошенной длительности. Стоимость, идентификаторы и URL поставщиков не возвращаются. Если результат отправки неизвестен, автоматически повторять запрос нельзя. Для сидов выше предела безопасных целых чисел JavaScript сериализуйте целое без потери точности; не округляйте его через Number.

Справочник Pro

MiniMax H3 (Hailuo 03) — мультимодальная видеомодель от MiniMax. Один запрос создаёт картинку и звук вместе: ролик на 4–15 секунд в 768P или 2K с собственными диалогами, фоновым звуком и эффектами. Тело запроса — официальный формат MiniMax с ID модели minimax-h3. Отправьте запрос, сохраните возвращённый идентификатор задачи и получите готовое видео из задачи. Кадры и референсы передаются как URL.

ID моделей

ID моделиВходные данныеРазрешенияДлительность
minimax-h3текст, первый и последний кадр, референсные изображения, видео и аудио768P, 2K4–15 секунд

Актуальные цены — на странице модели.

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

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3",
    "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
ЗаголовокЗначение
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json

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

Параметры

ПолеТипПо умолчаниюПримечания
modelstringобязательноminimax-h3
contentarrayобязательноПромпт и любые медиа в виде элементов, описанных ниже. Ровно один непустой элемент text.
resolutionenumобязательно768P или 2K.
durationintegerобязательноЛюбое целое число от 4 до 15 секунд.
ratioenumзависит от входаadaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16. Обязательно, если есть только текст; в этом случае adaptive не принимается.
content_filterbooleantrueФильтр контента SeedRouter, описан ниже. Модели не передаётся.

Схема строгая: неизвестные поля отклоняются, а не игнорируются. callback_url недоступен; вместо этого опрашивайте задачу. extra относится к MiniMax-H3-Max и для этой модели не принимается.

Элементы content

typeЭлементrole
text{"type": "text", "text": "..."}, до 7 000 символовнет
image_url{"type": "image_url", "image_url": {"url": "https://..."}, "role": "..."}first_frame, last_frame или reference_image
video_url{"type": "video_url", "video_url": {"url": "https://..."}, "role": "reference_video"}reference_video
audio_url{"type": "audio_url", "audio_url": {"url": "https://..."}, "role": "reference_audio"}reference_audio

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

Режимы

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

Режимcontent содержитratio
Текст в видеоодин элемент textобязательно, не adaptive
Изображение в видеоtext плюс изображение first_frame и/или last_frameлюбое значение считается adaptive: форму задаёт изображение
Референсы в видеоtext плюс любое сочетание до 9 элементов reference_image, 3 reference_video и 3 reference_audioнеобязательно, по умолчанию adaptive

Кадры и референсы нельзя совмещать в одном запросе.

{
  "model": "minimax-h3",
  "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": "2K",
  "duration": 6
}

Медиавходы

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

ВходФорматОграничения
ИзображениеJPG, JPEG, PNG, WebP, HEIC, HEIFДо 30 МБ; каждая сторона 256–5760 px; ширина / высота 0,4–2,5
ВидеоMP4, MOV (H.264 или H.265)До 50 МБ; 2–15 секунд каждое, 15 секунд в сумме; каждая сторона 256–5760 px; ширина / высота 0,4–2,5; 23,976–60 fps
АудиоWAV, MP3До 15 МБ; 2–15 секунд каждое, 15 секунд в сумме

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

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

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

Факторы стоимости

Актуальные тарифы смотрите в разделе цен модели. MiniMax H3 тарифицируется за секунду видео по тарифу, который зависит от разрешения результата, плюс входные изображения сверх первых пяти:

billed seconds = duration + ceil(Σ each reference video's seconds)
extra images   = max(0, number of images − 5)
cost = billed seconds × rate per second + extra images × rate per image

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

Схема вывода

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

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

Получение задачи

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

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

Выполненная задача

{
  "id": "task_...",
  "model": "minimax-h3",
  "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. В нашем тесте ролик 768P на 4 секунды с 16:9 пришёл в MP4 (H.264) с разрешением 1344 × 768 и частотой 24 fps, со стереодорожкой AAC 32 кГц.

Ошибки

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

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

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

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

Советы

  • Описывайте план и его звук вместе: объект, место, камеру, свет, диалоги и эффекты.
  • Вписывайте диалог в промпт и прикрепляйте референсный аудиоклип, если голос должен ему следовать.
  • Делайте черновик в 768P, а затем рендерите финальный план в 2K тем же запросом.
  • Используйте первый и последний кадр, чтобы задать начало и конец плана; используйте референсы, чтобы сохранить товар, человека или движение.
  • Добавьте no text, no logos, чтобы в кадре не появлялись выдуманные знаки.

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