Guía de la API de Wan 3.0: modelos, entradas y tu primer vídeo
Compara las entradas API y las especificaciones de salida de Wan 3.0, Wan 3.0 Prime, Wan 3.0 Pro y Wan 3.0 Prime Pro y prepara tu primera prueba de vídeo.
La primera decisión al integrar la API de Wan 3.0 es el material con el que quieres que trabaje el modelo: una escena escrita, una imagen inicial o un conjunto de referencias. Alibaba Cloud documenta Wan 3.0 como un modelo de vídeo capaz de generar hasta 30 segundos en una sola pasada y aceptar texto, imágenes, audio, vídeo y documentos. 1
Esta guía explica esas opciones y cómo preparar una primera prueba. Describe las capacidades del proveedor del modelo; el endpoint de producción y los detalles de acceso a las claves de Wan API se publicarán en su documentación de integración. Las tarifas de los modelos están en la página de precios. Cada modelo de la lista siguiente tiene su propia página de especificaciones.
Entiende los nombres de los modelos
Wan 3.0 es la familia de modelos. La integración oficial de Comfy también incluye wan3.0-video-prime como modelo seleccionable. Esto confirma que Prime es una opción distinta, pero el nombre de un modelo de un proveedor no determina por sí solo su esquema de solicitud, su disponibilidad en otro servicio ni el tiempo de respuesta que obtendrá tu aplicación. 2
| Nombre | Qué comprobar antes de integrar |
|---|---|
| Wan 3.0 | Flujos de texto, imagen y referencias; salida en 480p, 720p y 1080p |
| Wan 3.0 Prime | Un modelo Prime independiente con tarifas propias; salida de hasta 1080p |
| Wan 3.0 Pro | La opción Pro documentada para salida en 1080p, 2K y 4K |
| Wan 3.0 Prime Pro | Una opción Prime Pro independiente con ajustes de 1080p, 2K y 4K |
Prime y Pro son variantes distintas: compara las resoluciones y el identificador exacto del modelo antes de elegir. Wan 3.0 y Prime admiten salida de hasta 1080p; Pro y Prime Pro añaden opciones de 2K y 4K.
Para que la comparación sea útil, envía el mismo prompt y las mismas referencias con idéntica duración y resolución. Registra el tiempo de finalización, el coste y si el resultado cumple tus instrucciones. El nombre del modelo no sustituye esa prueba.
Elige la entrada adecuada para tu material
Comfy documenta tres flujos de Wan 3.0: texto a vídeo, imagen a vídeo y referencias a vídeo. Su flujo de imagen acepta un primer fotograma y un último fotograma opcional. Su flujo de referencias usa imágenes, vídeo y audio, con etiquetas como @Image1, @Video1 y @Audio1 para describir la función de cada entrada. Esos nombres y etiquetas pertenecen a esa integración; usa los campos documentados por tu proveedor de API. 2
| Material de partida | Una primera prueba práctica |
|---|---|
| Una escena escrita | Describe un sujeto, una acción y un movimiento de cámara |
| Una fotografía de producto | Explica el movimiento e identifica los detalles que deben mantenerse |
| Varias referencias | Asigna una función a cada una: identidad, aspecto del producto, movimiento o sonido |
| Una presentación o un documento | Empieza con una sección breve, un público definido y un mensaje claro |
La entrada de documentos de Alibaba admite un archivo o enlace, con archivos de hasta 100 MB. El límite de 50 páginas se aplica a los archivos PDF, DOCX, DOC, PPTX, PPT, KEY y PAGES. Una pasarela puede ofrecer menos modos de entrada, así que verifica la compatibilidad con documentos antes de diseñar un flujo de subida basado en ellos. 1
Haz que la primera prueba sea fácil de evaluar
Empieza con un clip breve y ajustes de salida explícitos. Por ejemplo, prueba un plano de producto de cinco segundos con un movimiento lento de cámara y sin diálogo. Estas son unas instrucciones de prueba sugeridas, no el cuerpo de una solicitud de API:
Una taza de café de cerámica está junto a una ventana con una suave luz de mañana. La cámara se acerca lentamente a la taza mientras asciende el vapor. Mantén constantes la forma y el color de la taza. Usa un ambiente de habitación tranquila, sin voces.
Configura deliberadamente la duración, la resolución, la relación de aspecto y el audio cuando tu proveedor ofrezca esos controles. El flujo actual de Wan de Comfy incluye audio por defecto y ofrece salida en 480p, 720p y 1080p. Esos ajustes documentados son un punto de partida útil, no una garantía de que todos los endpoints de Wan ofrezcan los mismos controles. 2
Revisa lo que tu aplicación realmente necesita del resultado: coherencia del sujeto, movimiento solicitado, audio y una composición aprovechable. Alibaba identifica la textura del audio y la precisión del texto en pantalla como aspectos que aún se están perfeccionando, así que revisa las voces y las letras generadas antes de usar el resultado en producción. 1
Comprueba el contrato de la API antes de crear el flujo
Antes de conectar una aplicación en producción, confirma en la documentación del proveedor el ID exacto del modelo, el método de autenticación, los formatos multimedia aceptados, el envío de tareas y la obtención de resultados, el comportamiento ante errores y las reglas de facturación. Mantén estos detalles separados del prompt creativo.
En Wan API, empieza por el resumen de modelos. Una solicitud autenticada que se complete correctamente en el endpoint publicado debería ser tu primer hito de integración; la página comercial por sí sola no es una especificación de API.
Fuentes
- Alibaba Cloud, Wan3.0: 30-Second AI Video Generation from Any Input. Publicado el 13 de agosto de 2026; consultado el 13 de octubre de 2026.
- Comfy, Wan 3.0 Video Generation in ComfyUI. Consultado el 13 de octubre de 2026. Los ajustes citados aquí corresponden a la integración de Comfy.
Novedades de Wan API
Acceso a la API y novedades de los modelos
Suscríbete para recibir un correo cuando se abra el acceso a Wan API y novedades sobre los modelos Wan.