Skip to main content
POST
Elección del modelo: use MiniMax-H3-Max cuando la velocidad sea prioritaria y baste con texto a vídeo o el control del fotograma inicial/final. Para 2K, fotogramas intermedios, imágenes, vídeos o audios de referencia, use MiniMax-H3.

Autenticación

string
requerido
Todos los endpoints requieren un Bearer Token. Obtenga su clave en la página de claves de API.

Elegir el modelo

MiniMax-H3-Max no admite 2K y su salida no puede usarse como origen para Regeneration.

Modos de generación

Los campos de la solicitud determinan el modo automáticamente; no envíe mode.
Este modelo no admite image_urls, video_urls, audio_urls ni image_with_roles[].role = "reference_image". Cualquier medio de referencia devuelve HTTP 400 antes de crear y cobrar la tarea.

Parámetros de solicitud

string
requerido
Valor fijo: MiniMax-H3-Max. No distingue mayúsculas y minúsculas; minimax-h3-max también se acepta.
string
requerido
Descripción no vacía del vídeo, obligatoria en todos los modos. Máximo de 7000 caracteres.
integer
predeterminado:"5"
Duración en segundos: entero de 5 a 15, valor predeterminado 5. No se admiten 4 segundos.
string
predeterminado:"768P"
Resolución de salida: 768P (predeterminada) o 480P.
2K, 1440P y 2048P no se admiten. Un valor no válido devuelve HTTP 400 sin reducción automática.
string
Relación de aspecto. También se aceptan los alias size y ratio.Valores T2V: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16.
  • T2V sin el campo o con adaptive: usa 16:9
  • I2V: la determina la imagen de entrada; este campo se ignora
string
URL pública de la imagen usada como fotograma inicial.
string
URL pública de la imagen usada como fotograma final. Puede usarse sola o junto con first_frame_image.
object[]
Array de imágenes con roles alternativo a first_frame_image y last_frame_image.Se admite como máximo una imagen por rol; role no puede estar vacío.
boolean
predeterminado:"false"
Añade una marca de agua AIGC. Alias: aigc_watermark.
string
Recibe una notificación cuando la tarea termina correctamente o con error.
Use webhook, no el callback_url de MiniMax. La puerta de enlace reserva callback_url para uso interno.

Parámetros no admitidos

Los siguientes valores devuelven HTTP 400 antes de crear y cobrar la tarea:
Para referencias, 2K, fotogramas intermedios o vídeo de 4 segundos, use MiniMax-H3.

Límites de las imágenes

El cuerpo total de la solicitud debe ser de 64 MB o menos. Use URL públicas; Base64 no es compatible.

Ejemplos

Imagen a vídeo con fotograma inicial

Imagen a vídeo con fotogramas inicial y final

Consultar una tarea

El envío devuelve task_id. Consulte el estado de la tarea cada 5–10 segundos y use un timeout de cliente de 15 minutos.
Las URL generadas suelen caducar tras unas 24 horas. Descargue y guarde el resultado cuanto antes.

Precios

Coste total = tarifa por segundo × duración. Las imágenes inicial y final son gratuitas. El importe estimado se reserva al enviar. Las tareas fallidas se reembolsan íntegramente; el campo cost de la tarea es definitivo.

Errores

Los fallos de generación devuelven status = failed y error.message, con reembolso automático.

Response

integer
Código de respuesta; 200 si es correcto
array
Resultado del envío con estado inicial e ID de tarea