Familia Hailuo (MiniMax)

Los modelos de generación de vídeo Hailuo de MiniMax, dos en total, que se invocan a través del endpoint de vídeo de OfoxAI POST /v1/videos. Las tareas se ejecutan de forma asíncrona: al crear una tarea se obtiene su ID, con el que después se consulta el resultado.

Elección de modelo

Ambos admiten texto a vídeo, imagen a vídeo y referencias de vídeo, y pueden generar una pista de audio sincronizada (generate_audio es true de forma predeterminada). adaptive conserva la proporción de la imagen de entrada.

La tabla anterior coincide con el video_attributes que devuelve la Models API; si cambian las capacidades de un modelo, prevalece lo que devuelva la API. La facturación es por segundo y el coste real es el usage.video_cost del resultado de la tarea; los precios están en la página del modelo .

Ejemplos de llamada

Los ejemplos siguientes solo muestran la petición de creación de la tarea. El flujo completo para consultar el estado y descargar el resultado está en Video API · Inicio rápido.

curl -X POST https://api.ofox.io/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/hailuo-3",
    "prompt": "Plano panorámico: un coche clásico avanza por una carretera del desierto hacia el sol poniente",
    "duration": 6,
    "resolution": "768p",
    "aspect_ratio": "21:9"
  }'

curl -X POST https://api.ofox.io/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/hailuo-3",
    "prompt": "La persona de la imagen se da la vuelta y camina hacia el fondo",
    "duration": 5,
    "frame_images": [
      { "type": "image_url", "image_url": { "url": "https://example.com/first.jpg" }, "frame_type": "first_frame" }
    ]
  }'

curl -X POST https://api.ofox.io/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/hailuo-3",
    "prompt": "Mantén el movimiento de cámara y cambia la imagen a un estilo de animación de tinta china",
    "duration": 5,
    "input_references": [
      { "type": "video_url", "video_url": { "url": "https://example.com/source.mp4" } }
    ]
  }'

• frame_images e input_references no pueden enviarse a la vez; si se envían juntos, se devuelve 400 references_conflict.
• Si no necesita pista de audio, envíe "generate_audio": false.
• La descripción completa de la estructura de campos está en Crear una tarea de vídeo.

Formato de la resolución

Los niveles de resolución de Hailuo son distintos de los de otras familias: 768p y 2k (con k minúscula). Enviar 720p o 1080p, habituales en otras familias, devuelve 400.

Errores habituales

Todos los códigos de error están en Códigos de error de Video API.

Documentación oficial

• Documentación de la plataforma abierta de MiniMax 
• OfoxAI · Crear una tarea de vídeo

Preguntas frecuentes