Por ahora esta guía solo está en inglés. →
Parámetros de la petición
| Parámetro | Obligatorio | Descripción |
|---|---|---|
seed | No | Repite el mismo número para obtener un resultado reproducible. ≥ 0 · ≤ 2147483647 |
prompt | Sí | Describe the subject, action, camera, light, pacing, and boundaries for the shot. |
resolution | No | Tamaño de salida. Más grande es más nítido y cuesta más. 480p · 720p · 1080p · Por defecto: 720p |
aspect_ratio | No | La forma del encuadre: horizontal, cuadrado o vertical. 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · adaptive · Por defecto: 16:9 |
generate_audio | No | Añade sonido acorde a la imagen: voces, ambiente y efectos. Por defecto: true |
enable_thinking | No | Let the model reason about the brief and the reference material before generating. Helps with complex references; slower. Por defecto: false |
duration_seconds | No | Cuánto dura el clip. Se cobra por segundo. -1–30 · Por defecto: 5 |
enable_prompt_expansion | No | Deja que el modelo añada detalles a un prompt corto. Por defecto: false |
Precios
Los precios están en créditos, los mismos que usas en la web (1 crédito = 0,01 $). El importe se retiene cuando se acepta la tarea y se liquida al coste real cuando termina; las tareas fallidas se reembolsan.
| Opción | Créditos por segundo | ≈ USD |
|---|---|---|
| resolution 480p | 6,75 | 0,068 US$ |
| resolution 720p | 13,5 | 0,14 US$ |
| resolution 1080p | 27 | 0,27 US$ |
Cada tarea se redondea al alza a créditos enteros, así que una ejecución en el nivel más bajo cuesta 34 créditos por un clip de 5 segundos (0,34 US$).
Para saber la cifra exacta antes de ejecutar, envía el mismo cuerpo a POST /jobs/quote.
Inicio rápido de la API
Llama a la API de Wan 3.0 en tres pasos
- Crea una clave de API. Inicia sesión en PopNow y crea una clave en la consola de la API. Las claves empiezan por sk-popnow- y usan los mismos créditos que el sitio web.
- Envía la solicitud. Haz POST /jobs/createTask con model alibaba/wan-3.0/text-to-video y un objeto input según la tabla de parámetros. La respuesta devuelve un ID de tarea al instante.
- Obtén el resultado. Consulta GET /jobs/recordInfo con el ID de tarea, o pasa una callBackUrl y te enviamos el resultado ahí. Descarga los enlaces de salida cuando la tarea termine bien.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/wan-3.0/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"aspect_ratio": "16:9",
"resolution": "720p",
"duration_seconds": 5
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Sustituye el prompt y los enlaces por los tuyos. La pestaña API tiene la referencia de la respuesta, el sondeo y el callback.
Preguntas sobre la API de Wan 3.0
¿Cuánto cuesta la API de Wan 3.0?
Wan 3.0 cuesta desde 34 créditos (0,34 US$) por un clip de 5 segundos con Crear video, su tarea más barata. Precios por opción: 480p 6,75 créditos por segundo, 720p 13,5 créditos por segundo, 1080p 27 créditos por segundo. Los créditos son los mismos que en la web (1 crédito = 0,01 $), las cuentas nuevas reciben 30 créditos gratis y las tareas fallidas se reembolsan.
¿Cuál es el nombre de modelo de Wan 3.0 en la API?
Pon alibaba/wan-3.0/text-to-video para Crear video; alibaba/wan-3.0/image-to-video para Imagen a video; alibaba/wan-3.0/reference-to-video para Referencias a video; alibaba/wan-3.0/video-extend para Extender video en el campo model de POST /jobs/createTask.
¿Cuánto puede durar un clip de Wan 3.0?
De dos a treinta segundos, fijados con duration_seconds como número entero. Por defecto son cinco. Los clips largos derivan más en identidad y en geometría, así que cierra el plano primero a cinco segundos.
¿Wan 3.0 genera audio?
Sí, y viene activo por defecto. Imagen y sonido vuelven en un solo archivo, ya alineados. Pon generate_audio en false cuando pienses añadir tu propia música.
¿Qué resoluciones admite Wan 3.0?
480p, 720p y 1080p, con 720p por defecto. Si necesitas 2K o 4K, usa Wan 3.0 Pro: publica otra escalera de resoluciones.
¿Puedo fijar el primer y el último fotograma?
En image-to-video, sí. image_url es el fotograma de apertura y last_image_url es opcional; enviar los dos sujeta dónde empieza el movimiento y dónde aterriza, que es lo que mantiene legible la geometría de un producto.
¿Cuántas imágenes de referencia acepta el reference-to-video?
Hasta diez imágenes, más hasta cinco videos y cinco archivos de audio de referencia. Los videos de referencia están limitados a quince segundos en total, y los audios también; tiene que llegar al menos uno de los tres arrays, un archivo de referencia o un enlace web, y el prompt es opcional.
¿Qué límites tiene la API de Wan 3.0?
Duración del clip: 2–30 s; Resoluciones: 480p · 720p · 1080p; Relaciones de aspecto: 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · adaptive. Las peticiones fuera de estos límites se rechazan antes de cobrar nada.
¿Puedo probar Wan 3.0 sin escribir código?
Sí. El Playground ejecuta Wan 3.0 con tus créditos de PopNow, no necesita clave API y te muestra el código de cada generación.
Todos los modelos de Wan
Wan 3.0 Pro renderiza el mismo tipo de planos a 1080p, 2K o 4K por un precio mayor. El Wan 3.0 normal es la mejor opción calidad-precio para borradores y clips para redes.
- API de Wan 3.0Clips de hasta 30 segundos con audio sincronizadoDesde 34 créditos por un clip de 5 segundos
- API de Wan 3.0 PrimeWan 3.0 más rápido, hasta 30 segundos con audioDesde 46 créditos por un clip de 5 segundos
- API de Wan 3.0 Pro PrimeWan 3.0 Pro más rápido, con salida 2K y 4KDesde 176 créditos por un clip de 5 segundos
- API de Wan 3.0 ProWan 3.0 en 1080p, 2K o 4K, hasta 30 segundosDesde 108 créditos por un clip de 5 segundos
- API de Wan 2.7 ProLienzos grandes en 4K y composiciones de nueve imágenesDesde 12 créditos por imagen
- API de Wan 2.7Piensa la composición y luego dibuja hasta cuatro imágenesDesde 5 créditos por imagen
- API de Wan 2.6 FlashClips multitoma rápidos a partir de una sola imagenDesde 17 créditos por un clip de 5 segundos
- API de Wan 2.6Secuencias multitoma con sonido, hasta 1080pDesde 49 créditos por un clip de 5 segundos
- API de Wan 2.5Clips 1080p con sonido que pueden seguir tu propio audioDesde 34 créditos por un clip de 5 segundos
- API de Wan 2.2 AnimateMueve la foto de un personaje con un video de referenciaDesde 7,95 créditos por segundo
- API de Wan 2.2 LoRAVideo Wan 2.2 con tus LoRA en cualquiera de las dos pasadas expertasDesde 18 créditos por un clip de 5 segundos
- API de Wan 2.2Clips sencillos de cinco segundos en 480p o 720pDesde 36 créditos por generación
- API de Wan 2.2 5B LoRAClips ligeros de Wan 2.2 en 720p que cargan tus LoRADesde 18 créditos por generación
- API de Wan 2.2 Image LoRAImágenes fijas con Wan 2.2 y hasta nueve LoRA en tres ranurasDesde 5 créditos por imagen
- API de Wan 2.1 LoRAVideo y ediciones con Wan 2.1 y tus LoRA, movimientos de cámara incluidosDesde 36 créditos por generación
- API de Wan 2.1 Image LoRAImágenes fijas y reestilizados fotorrealistas con Wan 2.1 y tus LoRADesde 5 créditos por imagen

