Wan 3.0 Pro

Wan 3.0 Pro admite texto, imágenes y medios de referencia, con salida a 1080p, 2K o 4K. Usa el endpoint Pro para estas opciones de resolución; no admite 480p ni 720p. Detalles del modelo y Playground.

Conecta con Wan APICopiar enlace del encabezado

Usa https://api.wanapi.app como URL base de la API. Crea una clave en la configuración de claves de API y envíala como Authorization: Bearer YOUR_API_KEY. Guarda las claves en tu servidor. El playground usa tu sesión del sitio web y descuenta el coste del mismo saldo de cuenta; no necesitas pegar una clave en el navegador.

El acceso requiere una cuenta habilitada con saldo suficiente. Consulta los precios para ver las tarifas actuales. Cada modelo tiene su propio endpoint y su página de modelo.

GET /v1/models muestra los modelos disponibles para tu clave. Elegir una resolución superior no cambia automáticamente el modelo.

Los campos compartidos de la solicitud describen los 14 campos nativos, los límites de los medios y las combinaciones de entradas. Este modelo usa w3.0-video-pro en la URL de las solicitudes nativas y como valor de model en las solicitudes de Responses.

Envía una tarea de Wan 3.0 ProCopiar enlace del encabezado

Esta solicitud genera un vídeo de dos segundos a partir de texto con la resolución más baja del modelo. Asigna tu clave a WAN_API_KEY en el servidor. El modelo se selecciona mediante la URL; no añadas un campo model a este cuerpo JSON nativo.

curl https://api.wanapi.app/wan/v1/w3.0-video-pro/generation \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A camera moves slowly along a quiet waterfront at sunrise.",
    "duration": 2,
    "resolution": "1080p",
    "ratio": "16:9",
    "audio": false,
    "prompt_extend": false
  }'

Consulta una tarea de Wan 3.0 ProCopiar enlace del encabezado

Guarda el task_info.id recibido como TASK_ID y consulta el mismo endpoint del modelo. La respuesta al envío confirma la recepción de la tarea, pero aún no contiene un vídeo terminado. Empieza consultando cada cinco segundos; consulta los estados de las tareas y las descargas.

curl "https://api.wanapi.app/wan/v1/w3.0-video-pro/generation/$TASK_ID" \
  -H "Authorization: Bearer $WAN_API_KEY"

Precios de Wan 3.0 ProCopiar enlace del encabezado

La tabla muestra las tarifas actuales en USD por segundo facturable. Se cuentan tanto los segundos de vídeo de referencia de entrada como los segundos de salida generados. El ejemplo de cinco segundos supone que no hay vídeo de referencia. Consulta facturación y gestión de fallos para conocer cómo funcionan las reservas y el ajuste del cobro.

Ver precios de Wan 3.0 Pro.

Campos de la solicitudCopiar enlace del encabezado

Los cuatro modelos comparten estos 14 campos nativos. Proporciona un prompt o al menos una entrada multimedia. No se pueden combinar fotogramas con entradas de referencia, file o link; file y link son mutuamente excluyentes.

Usa URL multimedia estables, accesibles directamente y disponibles hasta que termine la tarea. La comprobación de la duración de vídeo utiliza lecturas HTTP Range de tamaño limitado; los servidores de vídeo deben admitir estas lecturas y exponer metadatos de duración MP4/MOV legibles. Estas comprobaciones no siguen redirecciones. No se admiten URL de redes privadas. La duración conjunta de las referencias y la salida no debe superar los 30 segundos. El playground acepta un cuerpo de solicitud JSON de hasta 32 MiB; usa URL para entradas más grandes.

Consulta el estado y descarga el vídeoCopiar enlace del encabezado

El endpoint de envío de cada modelo devuelve un ID público de tarea. Guárdalo antes de continuar.

{
  "task_info": {
    "id": "task_EXAMPLE",
    "status": "pending"
  }
}

Usa el ejemplo de consulta del capítulo del modelo correspondiente. Empieza con un intervalo de cinco segundos y auméntalo tras errores temporales. Guarda el ID del modelo junto con el ID de cada tarea; no la consultes mediante el endpoint de otro modelo.

Los estados nativos son pending, processing, completed y failed. Una respuesta completada incluye videos, un array con una URL firmada completa de Bunny CDN.

{
  "task_info": { "id": "task_EXAMPLE", "status": "completed" },
  "videos": ["https://reapiflexible.b-cdn.net/flexible/v1/expires/2026-11/20261113T06/wanapi-task_EXAMPLE/video.mp4?token=HS256_SIGNATURE&expires=1794550071"]
}

Usa directamente la URL devuelta para reproducir o descargar el vídeo; esa URL no requiere clave API ni encabezado Authorization. Los archivos siguen la política de conservación existente del almacenamiento. Consultar una tarea no genera otro vídeo, no produce cargos adicionales ni amplía la disponibilidad del archivo. Guarda los archivos que quieras conservar en tu propio almacenamiento. Las consultas de tareas requieren tu clave API y solo devuelven tareas de tu cuenta.

Responses síncronas y en segundo planoCopiar enlace del encabezado

Para los clientes que usan la API Responses, POST /v1/responses acepta un ID de modelo, un input de tipo string y los mismos campos nativos de generación. Usa input en lugar de prompt. Los campos multimedia nativos, como reference_images, permanecen en el nivel superior.

{
  "model": "w3.0-video-pro",
  "input": "A blue ball rolls across a white table.",
  "resolution": "1080p",
  "duration": 2,
  "background": true
}

Con background: true, guarda el ID de respuesta y consulta GET /v1/responses/{response_id}. Sin background, la solicitud HTTP espera hasta que termine la generación. stream: true utiliza eventos enviados por el servidor (SSE) durante la espera. La salida final del asistente contiene una URL de vídeo firmada; trátala como un enlace privado que otorga acceso al vídeo y evita publicarla por accidente. Para generaciones largas o proxies con tiempos de espera restrictivos, se recomienda enviar tareas nativas o usar Responses en segundo plano.

Si una solicitud síncrona se desconecta o agota el tiempo de espera, la generación no se cancela. La tarea permanece en el servidor. No vuelvas a enviar automáticamente la misma solicitud de generación.

Facturación y gestión de fallosCopiar enlace del encabezado

El precio es la tarifa del modelo para la resolución elegida multiplicada por los segundos facturables. Se cuentan tanto los segundos de vídeo de referencia como los de salida; las entradas de texto, imágenes y audio no añaden segundos de vídeo. Las solicitudes de duración fija sin vídeo de referencia reservan el coste de la duración de salida solicitada. Las solicitudes con duración automática o vídeo de referencia reservan hasta 30 segundos facturables; después se ajusta el cobro al uso medido y se devuelve la parte no utilizada de la reserva. Los fallos de generación liberan la reserva. Consultar el estado no crea otra generación ni supone un nuevo cobro.

• Parámetros no válidos: corrige la solicitud antes de volver a enviarla. Se rechazan los campos nativos desconocidos.
• Saldo insuficiente: añade fondos antes de enviar una nueva solicitud de pago. El límite de una clave no concede crédito a la cuenta.
• Límites de solicitudes o fallos temporales al consultar el estado: reintenta solo la consulta, aumentando progresivamente el intervalo y con un tiempo máximo de espera.
• Tiempo de espera agotado al enviar, interrupción de red o ausencia de ID de tarea: el resultado del envío puede ser desconocido. No repitas automáticamente el POST; podría crear una segunda tarea de pago.
• Fallo de la tarea: distingue el estado de fallo de una consulta de estado no disponible.
• Fallo de descarga: reintenta la descarga de la tarea ya completada antes de iniciar otra generación.

Los envíos de generación no se reintentan automáticamente ni se cambian a otro modelo. No se ha anunciado compatibilidad con cancelación, webhooks o claves de idempotencia. Conserva el ID de tarea y contacta con soporte si es necesario investigar un envío cuyo resultado no esté confirmado.