MiniMax-H3
Generación de vídeo MiniMax-H3-Max
- Versión rápida de MiniMax Video Generation V2 con envío asíncrono de tareas
- Admite texto a vídeo e imagen a vídeo con fotograma inicial, final o ambos
- Admite 768P / 480P, duraciones de 5 a 15 segundos y pista de audio
- No admite 2K, fotogramas intermedios ni referencias multimodales
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
Modos de generación
Los campos de la solicitud determinan el modo automáticamente; no envíemode.
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.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: usa16: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: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 devuelvetask_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