MiniMax H3 Max Turbo

Genera vídeos de 5 a 15 segundos en 480P o 768P con texto o primer y último fotograma. Campos, límites de imagen, precios por segundo de salida y consulta de tareas.

MiniMax H3 Max Turbo genera vídeos cortos a partir de texto o fotogramas. Usa el ID de modelo minimax-h3-max-turbo, guarda el identificador de tarea devuelto y consulta el vídeo terminado. Esta página describe la interfaz nativa con array content que ofrece SeedRouter.

ID de modelo

ID de modelo	Entradas	Resoluciones	Duración
`minimax-h3-max-turbo`	texto, primer fotograma, último fotograma opcional	480P, 768P	De 5 a 15 segundos

Consulta la página del modelo para ver los precios actuales.

Ejemplo rápido

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"
  }'

Endpoint

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

Encabezado	Valor
Authorization	`Bearer YOUR_API_KEY`
Content-Type	`application/json`

La respuesta es una tarea ({"id": "task_...", "status": "processing"}), no el vídeo terminado. Consulta GET /v1/tasks/{task_id} para obtener el resultado. Guarda las claves de API en código del lado del servidor.

Parámetros

Campo	Tipo	Por defecto	Notas
`model`	string	obligatorio	`minimax-h3-max-turbo`
`content`	array	obligatorio	El prompt y los archivos multimedia, como elementos descritos abajo. Exactamente un elemento `text` no vacío.
`resolution`	enum	obligatorio	`480P` o `768P`.
`duration`	integer	obligatorio	Cualquier entero de 5 a 15 segundos.
`ratio`	enum	según la entrada	`adaptive`, `21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16`. Obligatorio solo con texto, donde no se acepta `adaptive`.
`extra`	object	omitido	Ajustes opcionales de expansión del prompt.
`extra.prompt_expansion_mode`	enum	`balanced`	`disabled`, `balanced` o `quality`. Omitir el objeto o la propiedad conserva el valor por defecto del modelo.
`content_filter`	boolean	`true`	El filtro de contenido de SeedRouter, descrito abajo. No se envía al modelo.

El esquema es estricto: los campos desconocidos se rechazan, no se ignoran. callback_url no está disponible; consulta la tarea en su lugar. extra es un objeto estricto opcional que solo contiene prompt_expansion_mode. Todos los campos rechazan null; omite los campos opcionales en su lugar.

Elementos de content

`type`	Elemento	`role`
`text`	`{"type":"text","text":"..."}`, hasta 7000 caracteres	ninguno
`image_url`	`{"type":"image_url","image_url":{"url":"https://..."},"role":"first_frame"}`	`first_frame` o `last_frame`

Se requiere exactamente un elemento de texto no vacío. Una imagen sola sin rol se considera el primer fotograma. Se acepta como máximo un primer y un último fotograma; un último fotograma requiere el primero. No se admiten imágenes, vídeo ni audio de referencia.

Modos

Los elementos de content determinan el modo; no se envía ningún campo mode.

Modo	Contenido	Proporción
Texto a vídeo	un elemento de texto	obligatoria; una de seis proporciones concretas, nunca `adaptive`
Imagen a vídeo	texto y primer fotograma, último opcional	sigue los fotogramas; otro valor válido no tiene efecto

{
  "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"}
}

Fotogramas

Usa URL HTTP(S) públicas sin credenciales integradas. No se aceptan Base64 ni ID mm_file://. Las imágenes pueden ser JPG, JPEG, PNG, WebP, HEIC o HEIF, de hasta 30 MB cada una, con lados de 256–5760 píxeles y ancho/alto entre 0,4 y 2,5. La entrada se comprueba antes de generar. Usa composiciones y proporciones compatibles para dos fotogramas.

Filtro de contenido

content_filter es true salvo que lo cambies. Con el filtro activado, la solicitud, con su texto y sus medios, se revisa antes de generar. Una solicitud marcada falla con el código 60001 y no se cobra. Establece content_filter en false para omitir la revisión; el Playground del sitio web siempre lo mantiene activado.

Factores de coste

La sección de precios del modelo muestra las tarifas actuales. Turbo tiene un solo cargo: segundos de salida a la resolución elegida. El primer y el último fotograma y la expansión del prompt no tienen cargos aparte.

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

La estimación usa los segundos enteros solicitados. La facturación final usa los segundos de salida de la tarea terminada a la tarifa registrada para la solicitud. Si no hay datos de uso válidos, se utiliza la estimación aceptada. La duración del contenedor multimedia puede diferir ligeramente de los segundos facturados. Consulta los cargos en el historial de uso de tu cuenta; las respuestas públicas de tareas no incluyen costes. Las tareas fallidas no se cobran.

Esquema de salida

El envío devuelve la tarea:

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

Consultar la tarea

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

Sondea cada 10–20 segundos hasta que status sea completed o failed. Que se agote el tiempo de red durante el sondeo no significa que la generación haya fallado: conserva el identificador de tarea y reanuda la comprobación. No crees otra tarea para consultar el progreso.

Tarea completada

{
  "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 es la proporción con la que se creó el clip, incluida la elegida para adaptive. La tarea contiene la resolución, proporción y duración reales cuando se declaran. El JSON anterior ilustra la estructura de respuesta; no es un resultado de generación medido.

Errores

Las solicitudes rechazadas antes de crear una tarea devuelven un error HTTP con un objeto error y no se cobran. Una tarea que falla después de aceptarse devuelve HTTP 200 al consultarla, con status: "failed" y un objeto error.

Consulta el catálogo de errores común para ver códigos, estados HTTP y pautas de reintento.

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

Si el propio envío agota el tiempo de espera, revisa tus tareas antes de volver a enviar: puede que la primera solicitud se haya aceptado.

Consejos

Describe un sujeto, una acción, un movimiento de cámara y una iluminación por plano.
Usa 480P para un borrador y 768P para más detalle de salida. Cada nueva generación es una solicitud de pago independiente.
Aporta un primer fotograma para establecer la composición inicial; añade uno final solo si también aportas el primero.
Usa extra.prompt_expansion_mode para elegir disabled, balanced o quality; omitirlo conserva balanced.
Revisa el clip completo y su audio antes de publicarlo. Un prompt no garantiza una geometría de producto o textos exactos.

Relacionado

Alcance del contrato

Esta interfaz usa el formato de solicitud con array content de MiniMax, ID de modelo SeedRouter, tareas asíncronas, imágenes solo por URL y entrega de resultados alojados. Los callbacks y la cancelación no están disponibles. content_filter es una comprobación de entrada de SeedRouter, no un parámetro de MiniMax.

La interfaz independiente alojada en fal tiene campos y límites distintos; sus controles de 1080P, duraciones fraccionarias, audio objetivo y referencias ordenadas no se aplican aquí. Esta interfaz no acepta controles de seed ni marca de agua. Consulta la guía comparativa para ver la distinción y las fuentes enlazadas.

On this page