Introducción
Wan 3.0 Pro Texto a video escribe un plano a partir de un prompt y lo entrega en 1080p, 2K o 4K durante 2 a 30 segundos, con el audio generado en el mismo archivo. prompt es el único campo obligatorio y admite hasta 20 000 caracteres. Un render nativo de Wan 3.0 llega como máximo a 1080p, así que los niveles 2k y 4k se amplían a partir de ese render en lugar de dibujarse a esos tamaños. Este endpoint no tiene nivel 480p ni 720p; esos tamaños los cubre Wan 3.0.
Elige el modo según el material inicial
| Material inicial | Modo |
|---|---|
| Un brief escrito define escena, acción, cámara y, cuando corresponde, sonido. | Wan 3.0 Pro Texto a video |
| Una imagen inicial aprobada fija sujeto y composición; la instrucción dirige el movimiento posterior. | Wan 3.0 Pro Imagen a video |
| Referencias separadas pueden guiar identidad, lugar, movimiento o sonido con una función clara para cada una. | Wan 3.0 Pro Referencias a video |
Funciones y aspectos destacados
Tres tamaños de entrega a partir de un render nativo
resolution acepta 1080p (por defecto), 2k o 4k. Los dos niveles mayores estiran lo que dibujó el modelo en vez de dibujar más, así que sirven para material que se va a recortar, rastrear o proyectar, y solo son tan buenos como el render de base. Encuentra el plano en 1080p primero y trata el 4K como un paso de entrega.
La expansión del prompt empieza activada
En esta familia enable_prompt_expansion es true por defecto. Completa un brief escueto, lo que resulta útil mientras bocetas, pero reescribe uno detallado. Cuando tu prompt ya sea una descripción precisa del plano, cambia el campo a false para que se ejecute exactamente la redacción que ajustaste.
Formato adaptable si no fijas uno
aspect_ratio es adaptive por defecto, así que el modelo elige el cuadro. Indica 16:9, 4:3, 1:1, 3:4 o 9:16 cuando el formato de entrega esté definido: el ejemplo de la cerca pide 9:16 para un cuadro vertical, mientras que los del perfume, el blanco y negro y el tatuaje fijan 16:9.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Sujeto, una acción, un movimiento de cámara y luego la luz y el sonido. En 4K un brief vago cuesta dinero de verdad: escribe el plano, no un estado de ánimo. mínimo 1 caracteres · máximo 20000 caracteres |
resolution | No | 1080p, 2k o 4k, 1080p por defecto. |
aspect_ratio | No | 16:9, 4:3, 1:1, 3:4, 9:16 o adaptive. Por defecto adaptive, que deja elegir al modelo; nombra una proporción cuando el formato de entrega esté fijado. |
duration_seconds | No | Cualquier número entero de 2 a 30, 5 por defecto, o -1 para la duración inteligente, en la que el modelo elige la longitud: se reservan de entrada los 30 segundos máximos y se c… |
generate_audio | No | Activo por defecto. El sonido se genera con la imagen y llega dentro del mismo archivo. Valor predeterminado: |
enable_prompt_expansion | No | Activa por defecto en esta familia. Rellena briefs flojos y reescribe los detallados, así que desactívala en cuanto tu prompt sea una descripción de plano precisa. Valor predeterminado: |
seed | No | De 0 a 2147483647. Déjala fija mientras ajustas resolución o duración; si no, cada repetición cambia dos cosas a la vez. |
Precios
| Especificación | Precio |
|---|---|
| $0.144 / segundo |
| $0.16 / segundo |
| $0.184 / segundo |
Casos de uso
Anuncios de perfume y belleza con luz dura
El ejemplo del perfume es un spot de cinco segundos en cámara lenta: una mujer adulta con un vestido negro de espalda descubierta se aparta de una ventana azotada por la lluvia mientras una única luz principal dura recorre su columna y le saltan gotas del pelo, con una nota grave de violonchelo y lluvia en la banda sonora. La tela brillante, una fuente dura única y las partículas pequeñas y rápidas son lo primero que se degrada al ampliar, así que revisa justo eso en una entrega 2K o 4K.
Tela movida por una sola fuerza externa
Dos ejemplos dirigen la ropa mediante una sola fuerza en vez de describir cómo cae. En la película de moda en blanco y negro, tres metros de gasa de seda frente a una máquina de viento industrial azotan el cuerpo y se enroscan en un hombro bajo una luz dura sobre fondo negro. En el ejemplo de la cerca, el chorro de un avión que aterriza aplasta la ropa de dos personas contra su cuerpo. Nombrar la fuerza le da a la tela una causa que seguir.
Guía de prompts y consejos prácticos
Explora en 1080p y vuelve a renderizar la semilla elegida
Encuentra el plano a 5 segundos y 1080p con seed fijo, cambia un campo en cada repetición y solo entonces envía el mismo prompt y la misma semilla con resolution en 4k. Si cambias resolución y texto en la misma repetición, no podrás saber cuál movió el resultado.
Escribe el plano, no un estado de ánimo
Sujeto, una acción, un movimiento de cámara y después luz y sonido. El prompt del estudio de tatuajes es un buen modelo: velas y una lámpara de escritorio como única luz, manos enguantadas sombreando un diseño sobre las costillas, un gesto de dolor, una exhalación lenta y una sonrisa por encima del hombro, la máquina zumbando, un acercamiento muy lento. En 4K, un brief vago es una forma cara de descubrir qué querías decir.
Nombra los sonidos que quieres oír
El sonido se genera con la imagen, así que enumera sus fuentes: el spot de perfume pide "low cello note and rain" y la película de la máquina de viento, "the roar of the fan and snapping cloth". Cambia generate_audio a false cuando un compositor vaya a musicalizar el spot. La familia acepta prompts sin censura sin declaración por solicitud; el consentimiento, los derechos, la edad y la ley local de todas las personas que aparecen son tu responsabilidad.
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-3.0-pro/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "1080p",
"aspect_ratio": "adaptive",
"duration_seconds": 5
}
}'
# 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.
