API de generación de vídeo MiniMax-H3
Genera tareas de vídeo MiniMax-H3 de forma asíncrona en APIMaster, consulta su estado y descarga MP4.
Generación de vídeo MiniMax-H3
Usa MiniMax-H3 mediante la API de vídeo compatible con OpenAI de APIMaster. La generación es asíncrona.
URL base:
https://apimaster.ai/v1eshttps://apimaster.ai/v1. Crea tareas conPOST https://apimaster.ai/v1/video/generations.
Compatibilidad y validación
Se admiten POST https://apimaster.ai/v1/video/generations y POST https://apimaster.ai/v1/videos/generations. Para un mismo modelo, los parámetros y la facturación son iguales; cada ruta conserva su formato de respuesta de creación. Los clientes actuales pueden mantener su ruta.
MiniMax-H3 conserva el ejemplo singular; size y resolution, y ratio y aspect_ratio, son alias. Los valores no admitidos o los alias contradictorios devuelven HTTP 400, sin cambiar silenciosamente a una resolución superior. Indique resolución, proporción y duración explícitamente.
Crear una tarea
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
model |
string | sí | MiniMax-H3 |
prompt |
string | condicional | Descripción del vídeo |
duration |
integer | no | 4–15 segundos, predeterminado 4 |
size |
string | no | 768P o 2K, predeterminado 768P |
ratio |
string | no | Relación de aspecto, predeterminada 16:9 |
curl -s "https://apimaster.ai/v1/video/generations" \
-H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"model":"MiniMax-H3","prompt":"A calm ocean at sunrise, cinematic wide shot","duration":4,"size":"768P","ratio":"16:9"}'
La respuesta devuelve id y task_id con estado queued.
Consultar el estado
GET https://apimaster.ai/v1/videos/{task_id} devuelve queued, in_progress, completed o failed.
curl -s "https://apimaster.ai/v1/videos/task_xxxxxxxx" -H "Authorization: Bearer YOUR_API_KEY"
Espera 10–20 segundos después del envío y consulta cada 3–5 segundos.
Descargar el vídeo
curl -L "https://apimaster.ai/v1/videos/task_xxxxxxxx/content" \
-H "Authorization: Bearer YOUR_API_KEY" -o output.mp4
Descarga el MP4 cuando el estado sea completed. duration admite 4–15 segundos y size admite 768P y 2K.
Vídeo desde referencias (r2v)
Envíe el array V2 oficial content al endpoint APIMaster indicado arriba. Debe incluir un elemento text no vacío; con content no se requiere prompt en el nivel superior. reference_image guía el sujeto o estilo, sin fijar el primer fotograma. El campo anterior images asigna las dos primeras imágenes a los fotogramas inicial y final. No mezcle estos roles con referencias.
{
"model": "MiniMax-H3",
"content": [
{"type": "text", "text": "Use the character in Image 1 as the subject, walking through a garden."},
{"type": "image_url", "image_url": {"url": "https://YOUR_PUBLIC_IMAGE_URL/reference.jpg"}, "role": "reference_image"}
],
"resolution": "768P",
"duration": 4,
"ratio": "16:9"
}
