Familia Wan y HappyHorse

Los modelos de generación de vídeo de Alibaba, seis 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

Los seis admiten texto a vídeo e imagen a 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.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan-3.0",
    "prompt": "Un pueblo de canales del sur de China al amanecer; una barca pasa lentamente bajo un puente de piedra",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

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

curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan-2.7",
    "prompt": "Mantén el movimiento de cámara y cambia la imagen a un estilo de animación de tinta china",
    "duration": 5,
    "resolution": "720p",
    "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.

Diferencias con otras familias

• Sin cancelación: una vez enviada la tarea upstream, DELETE /v1/videos/{id} devuelve 400 cancel_not_supported, y la tarea sigue generándose y facturándose. Compruebe los parámetros antes de enviarla.
• Dirección del vídeo: en las pruebas, al completarse la tarea solo se devuelve unsigned_urls (dirección temporal de Alibaba Cloud OSS), sin mirror_urls. La dirección temporal puede caducar a las 24 horas; descargue y guarde el vídeo cuanto antes.
• Duraciones más cortas: Wan admite un mínimo de 2 segundos y HappyHorse de 3 segundos; en las demás familias el mínimo es de 4 segundos.

Quitar la marca de agua

Los parámetros propios de los modelos de Alibaba se pasan mediante provider.options.dashscope:

{
  "model": "alibaba/wan-3.0",
  "prompt": "...",
  "duration": 5,
  "resolution": "720p",
  "provider": {
    "options": { "dashscope": { "watermark": false } }
  }
}

provider.options solo se transmite al proveedor que coincide; los demás proveedores no lo reciben. La descripción completa está en Enrutamiento de proveedores de vídeo.

Errores habituales

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

Documentación oficial

• Alibaba Cloud Model Studio (Bailian) · Documentación del servicio de modelos 
• OfoxAI · Crear una tarea de vídeo

Preguntas frecuentes