MiniMax H3 Max

MiniMax H3 Max es la variante de generación más rápida de MiniMax H3. Una solicitud crea la imagen y el sonido a la vez: un clip de 5 a 15 segundos en 480P o 768P con su propio diálogo, ambiente y efectos. El cuerpo de la solicitud sigue el formato oficial de MiniMax con el ID de modelo minimax-h3-max. Envíalo, guarda el identificador de tarea devuelto y recupera el vídeo terminado desde la tarea. Los fotogramas y las referencias se envían como URL.

ID de modelo

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

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

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

Una sola imagen sin role es el primer fotograma. Con más de una imagen, cada imagen necesita un role.

Modos

Los elementos de content deciden el modo; no hay un campo de modo.

Los fotogramas y las referencias no se pueden combinar en una solicitud. La documentación oficial menciona la entrada de solo último fotograma, pero también contiene el requisito contradictorio de acompañarlo de un primer fotograma. Ese caso no se ha verificado en SeedRouter. Usa ambos fotogramas cuando necesites una imagen final.

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

Entradas multimedia

Cada elemento de imagen, vídeo y audio es una URL HTTP(S) pública. No se aceptan data URI en base64 ni identificadores mm_file://: sube el archivo a tu propio almacenamiento y pasa su URL.

Los vídeos de referencia se miden cuando se acepta la solicitud; uno cuya duración no se puede leer se rechaza sin cobrar nada. Los demás límites se comprueban antes de generar, y una solicitud que incumple alguno falla sin coste.

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

Consulta la sección de precios del modelo para ver las tarifas actuales. MiniMax H3 Max cobra los segundos de salida generados y los segundos de vídeo de referencia por separado, según la resolución de salida. Las dos primeras imágenes son gratis; cada imagen posterior añade un cargo.

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

Las duraciones de los vídeos de referencia se suman y se redondean al segundo entero más cercano para el uso final. Dos clips de 2,4 segundos aportan, por tanto, cinco segundos de entrada. El audio de referencia no tiene cargo de entrada. Primer y último fotograma cuentan como imágenes, así que dos fotogramas solos no añaden cargos de imagen.

La estimación del Playground redondea las duraciones de referencia hacia arriba para cubrir el posible coste final. El uso final se cobra a la tarifa registrada para tu solicitud. Si no hay un informe de uso completo, se utiliza la estimación aceptada. 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", "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",
  "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",
  "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 el plano y su sonido juntos: sujeto, lugar, cámara, luz, diálogo y efectos.
• Escribe el diálogo en el prompt y adjunta un clip de audio de referencia cuando la voz deba seguirlo.
• Haz un borrador en 480P y elige 768P si necesitas más detalle. Cada nueva generación es una solicitud de pago independiente.
• Usa extra: {"prompt_expansion_mode": "disabled"} para un prompt ya completo, o elige la expansión balanced / quality.
• Usa un primer y un último fotograma para controlar dónde empieza y termina un plano; usa referencias para mantener un producto, una persona o un movimiento.
• Añade no text, no logos para evitar marcas inventadas.

Relacionado

• Playground y precios de MiniMax H3 Max
• Descargar OpenAPI
• Markdown para copiar

Fuentes del contrato

Los parámetros siguen la documentación de generación de vídeo de MiniMax. SeedRouter usa su propio ID de modelo, tareas asíncronas, medios solo por URL y entrega de resultados alojados; los callbacks y la cancelación no están disponibles. content_filter es una extensión de SeedRouter.