Introducción
Wan 2.2 texto a video genera un clip solo a partir de un prompt escrito. Cada solicitud devuelve un único video sin sonido de cinco segundos, en 16:9 o 9:16, renderizado en 480p o 720p. El prompt admite hasta 5,000 caracteres y es el único campo obligatorio: la relación de aspecto es 16:9 por defecto, la resolución 480p, y la expansión del prompt queda desactivada salvo que la actives.
Elige un modo de Wan 2.2 según el material de partida
| Lo que tienes al empezar | Modo | Lo que necesita la solicitud |
|---|---|---|
| una escena escrita o un guion | Wan 2.2 texto a video | un prompt; 16:9 o 9:16 |
| una imagen fija que quieres conservar | Wan 2.2 imagen a video | una imagen y un prompt; la imagen define el formato |
Funciones y aspectos destacados
Una toma fija de cinco segundos
Texto a video no tiene ajuste de duración: cada toma dura exactamente cinco segundos, así que conoces la duración de una solicitud antes de enviarla. En cinco segundos cabe un solo momento (un sujeto, una acción y un movimiento de cámara), no una secuencia de sucesos. Los prompts escritos a esa escala son los que dan resultados más confiables.
Dos formatos y dos resoluciones
La relación de aspecto es 16:9 por defecto, o 9:16 para publicación vertical. No hay cuadros cuadrados ni 4:3, así que para una entrega cuadrada genera en 16:9 y recorta en la edición. La resolución es 480p o 720p, y es el único ajuste que cambia el precio, por lo que 480p es el nivel natural para borradores.
Solo imagen
Los clips llegan sin pista de audio y no existe ningún ajuste de sonido. Todo lo que el espectador deba sentir tiene que verse: el ejemplo publicado del andén nevado construye su ritmo con nieve que cae, aliento que se condensa por el frío y una lámpara del andén que parpadea, en lugar de depender del ambiente sonoro.
Expansión del prompt y seed opcionales
La expansión del prompt reescribe una indicación breve en una versión más completa antes de generar. El seed acepta valores de 0 a 2147483647 y mantiene fija la fuente aleatoria para que compares un cambio a la vez; no garantiza un clip idéntico cuadro por cuadro en una segunda ejecución.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | El plano en sí, hasta 5000 caracteres: quién, una acción, un movimiento de cámara y luego la luz. Un verbo claro mueve el resultado más que una pila de adjetivos. mínimo 1 caracteres · máximo 5000 caracteres |
aspect_ratio | No | 16:9 o 9:16, 16:9 por defecto. Este endpoint no ofrece cuadrado ni 4:3. |
resolution | No | 480p o 720p, 480p por defecto. Es el único ajuste que cambia el precio. |
enable_prompt_expansion | No | Desactivado por defecto. Al activarlo, un brief corto se reescribe en uno más completo antes de generar; déjalo desactivado cuando tu prompt ya describa el plano con precisión. Valor predeterminado: |
seed | No | De 0 a 2147483647. Mantenlo fijo para comparar un cambio a la vez; omítelo si buscas variedad. |
Precios
Cada solicitud devuelve un clip de cinco segundos.
| Especificación | Precio |
|---|---|
| $0.24 / solicitud |
| $0.48 / solicitud |
Casos de uso
Borradores de storyboard en lote
Escribe cada momento del storyboard como un prompt independiente y renderiza toda la lista en 480p. Cinco segundos bastan para evaluar el encuadre y el movimiento, y como todas las solicitudes duran lo mismo y el precio depende solo de la resolución, conoces el costo del lote antes de enviarlo. Vuelve a renderizar en 720p las tomas que conserves, con el mismo prompt y el mismo seed.
Clips verticales para redes sociales
Ajusta la relación de aspecto a 9:16 y describe una sola acción continua. El ejemplo publicado del mercado nocturno hace justo eso en 720p: una joven con impermeable amarillo toma una brocheta en un puesto de parrilla, el humo y el vapor suben entre guirnaldas de focos, y ella se da la vuelta y camina hacia la cámara, que se acerca despacio en mano.
Comprobar si una idea de plano funciona en movimiento
Antes de comprometerte con una toma en 720p, puedes probar la idea a bajo costo. El ejemplo de la escalera del faro está escrito como una acción y una posición de cámara (un hombre mayor con una linterna sube la última vuelta de una escalera de caracol mientras una cámara baja lo sigue) y renderizado en 16:9 a 480p.
Guía de prompts y consejos prácticos
Escribe un solo momento en un orden fijo
Nombra el sujeto, la única acción, un movimiento de cámara y, al final, la luz. Un verbo claro mueve el resultado más que una pila de adjetivos: un hombre que sube la última vuelta de una escalera y se detiene ante una ventana le da al clip un inicio y un final dentro de cinco segundos.
Usa los caracteres para detalles, no para más escenas
El límite de 5,000 caracteres deja espacio para vestuario, escenografía, clima y luz, pero cinco segundos no sostienen un segundo suceso. Si una indicación contiene varios, repártelos en solicitudes separadas y únelos en la edición.
Mantén el seed mientras corriges
Elige un seed y consérvalo mientras cambias una sola cosa, como un verbo, el movimiento de cámara o la relación de aspecto. El ejemplo del mercado nocturno fija el seed 250728 para que el mismo encuadre pueda compararse entre versiones del prompt. Omite el seed cuando busques variedad.
Decide pronto sobre la expansión del prompt
Si solo tienes una idea de una línea, al activar la expansión del prompt el servicio redacta por ti una indicación más completa. Cuando tu prompt ya nombra sujeto, acción, cámara y luz, déjala desactivada para que el texto se ejecute tal como está escrito, y evalúa cualquier versión expandida frente a una sin expansión.
Reconoce cuándo el texto no alcanza
Un prompt por sí solo no mantiene estable un rostro o un producto concreto de una ejecución a otra. Cuando el sujeto deba coincidir con una imagen fija aprobada, cambia a Wan 2.2 imagen a video y deja que la imagen defina la apariencia.
Inicio rápido de la API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/wan-2.2/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "480p",
"aspect_ratio": "16:9"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.
