Introducción
Wan 2.6 Spicy Imagen a video es el único endpoint de la familia de modelos Wan 2.6 Spicy. Un fotograma inicial autorizado se convierte en exactamente 5, 10 o 15 segundos en 720p o 1080p, que vuelven con sonido. El fotograma aporta vestuario, cuerpo, set, luz y formato del cuadro; el prompt aporta el movimiento. Nada en la solicitud marca un clip, y no hace falta ninguna declaración por solicitud.
Solo image_url es obligatorio. El prompt, el prompt negativo, la pista de audio, el tipo de plano, la expansión del prompt y el seed son opcionales.
Funciones y aspectos destacados
Tres duraciones fijas
duration_seconds es una lista cerrada de 5, 10 y 15, no un rango. Enviar 7 devuelve un error de validación en lugar de un clip redondeado, así que siempre sabes cuántos segundos pagas y puedes planificar la edición en torno a tres duraciones. El agua, el cabello y las manos se sostienen bien a los cinco segundos y se desvían más a los quince, algo que conviene sopesar antes de elegir la opción más larga.
Tu propia pista con audio_url
Los clips siempre vuelven con sonido; no hay un interruptor para quitarlo. Cuando una línea hablada o una pista musical tiene que caer en un fotograma concreto, envíala con audio_url y el clip la sigue en sincronía labial y ritmo. El archivo debe ser WAV o MP3, de 3 a 30 segundos y de no más de 15 MB.
Un campo aparte para las exclusiones
negative_prompt es donde se deja fuera, en hasta 500 caracteres, a una segunda persona, un objeto, texto en pantalla o una marca de agua que el fotograma sigue reproduciendo. El prompt, de hasta 1500 caracteres, queda libre para el movimiento. Volver a describir la ropa o el set en el prompt invita al modelo a redibujar lo que el fotograma ya fijó.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
image_url | Sí | El cuadro de apertura. Vestuario, cuerpo, set, dirección de la luz y la proporción del clip salen todos de él, así que recórtalo primero a la forma de entrega. |
prompt | No | Opcional. Describe qué pasa después del cuadro: una acción, un comportamiento de cámara y una nota sobre el sonido. máximo 1500 caracteres |
negative_prompt | No | Lo que no debe aparecer: una segunda persona, un objeto, texto en pantalla o una marca de agua que la plancha insista en reproducir. El único lugar para excluir algo. máximo 500 caracteres |
duration_seconds | No | Exactamente 5, 10 o 15. Cualquier otra cosa se rechaza en vez de redondearse, así que la duración que pagas nunca es una sorpresa. |
resolution | No | 720p o 1080p, con 720p por defecto. Mueve tanto el precio como el tiempo que tarda la tarea en volver. |
audio_url | No | Una pista de audio que el clip debe seguir, y que guía la sincronía labial y el ritmo. Úsala cuando una línea hablada o una entrada musical tenga que caer en un cuadro concreto. |
seed | No | De 0 a 2147483647. Mantenla fija mientras comparas resoluciones o duraciones desde la misma plancha. |
shot_type | No | Plano único mantiene todo el clip en una sola toma. Múltiple deja que el modelo corte entre planos: va bien para una escena corta, pero rompe la continuidad. |
enable_prompt_expansion | No | Desactivada por defecto, así que el prompt se envía tal como lo escribes. Actívala para completar un brief flojo. Valor predeterminado: |
Precios
| Especificación | Precio |
|---|---|
| $0.095 / segundo |
| $0.1425 / segundo |
Casos de uso
Agua y luz
El ejemplo de piscina publicado parte de una imagen fija de una nadadora que sale de una piscina en la azotea a la hora azul. Como el encuadre contiene el atuendo, el agua y la ciudad detrás de ella, el prompt solo dice que se incorpora más, se peina el pelo hacia atrás y abre los ojos hacia la cámara. Dura cinco segundos a 720p.
Escenas para dos
Un encuadre con dos personas se trata como cualquier otra continuación: el clip continúa lo que muestre el fotograma inicial, y después no se revisa nada. El ejemplo del camerino mantiene el mismo encuadre durante todo el clip mientras una persona se mueve detrás de la otra, renderizado a 1080p durante cinco segundos.
Personajes de compañía con tu propia pista de voz
Reutiliza la imagen de un personaje como fotograma inicial y sube una línea grabada con audio_url. El movimiento de los labios y el ritmo siguen tu toma, así que la misma cara puede decir un guion en lugar de hacer movimientos genéricos.
Spots de quince segundos en una sola llamada
Quince segundos cubren un pre-roll completo o una tarjeta de historia sin edición. Un fotograma inicial, una línea de acción, una solicitud, y como la duración es uno de tres valores fijos, queda definida antes de enviar.
Guía de prompts y consejos prácticos
Recorta el fotograma al formato de entrega
La foto decide la persona, el vestuario, la ubicación, la luz y las proporciones del clip. No hay un campo de relación de aspecto, así que recórtala a 16:9, 9:16 o cuadrado antes de enviarla; reencuadrar después cuesta un nuevo render. Envía JPEG, PNG sin transparencia, BMP o WEBP, de 240 a 8000 píxeles por lado y de no más de 20 MB.
Construye un clip con movimientos pequeños
El ejemplo de la luz de persiana se compone de dos movimientos diminutos, un pie que se flexiona y una rodilla que se estira, mientras la seda se desplaza debajo. La luz hace el resto cuando las franjas avanzan mientras la persiana se mueve, y la cámara es un balanceo en primera persona a mano en lugar de un movimiento. Acciones pequeñas y concretas como estas dan algo que hacer al encuadre sin pedirle que cambie.
Escribe un límite en el prompt cuando la cámara está fija
En el ejemplo del camerino de diez segundos, todo lo que importa está en una sola línea horizontal, y el prompt indica con claridad qué debe quedar fuera del encuadre. Cuando la cámara no se mueve, expresar la restricción en el prompt se mantiene con más fiabilidad que intentar resolverla con el encuadre, porque tiene que sostenerse durante todo el clip.
Adapta el ejemplo incluido
Empieza por el ejemplo publicado con duration_seconds: 5, image_url: a publicly accessible URL, resolution: 720p. Cambia el sujeto y el movimiento manteniendo intacto el contrato de entrada de este modo.
She rises further out of the water, sheets of it running off her shoulders and swimsuit, slicks her wet hair straight back with both hands and opens her eyes toward camera, droplets scattering. Blue-hour city towers glow behind, slow-motion water detail, ambient pool lap and distant traffic.
La solicitud exacta detrás del clip de este endpoint, generada a partir del fotograma inicial que se muestra al lado.
Ajusta en 720p y renderiza la elegida en 1080p
La resolución cambia tanto el precio como el tiempo que tarda la tarea. Ajusta el movimiento en 720p y luego vuelve a renderizar la versión elegida en 1080p con el mismo fotograma y el mismo seed, que acepta de 0 a 2147483647. Mantén ambos fijos también al comparar cinco segundos contra quince; si no, estás comparando dos clips distintos y no dos ajustes. El seed estabiliza el resultado, pero no garantiza un clip idéntico.
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.6-spicy/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"resolution": "720p",
"shot_type": "single"
}
}'
# 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.




























