Introducción
Wan 3.0 Pro Prime Texto a video genera un plano de 2 a 30 segundos a partir de un prompt y lo entrega en 1080p, 2K o 4K con el audio en el mismo archivo. Su lista de campos coincide exactamente con la de Wan 3.0 Pro Texto a video, pero el render base es Wan 3.0 Prime, que Alibaba presenta como la versión de alta velocidad con las mismas capacidades. Un render nativo de Prime llega como máximo a 1080p, así que los niveles 2k y 4k se amplían a partir de él en lugar de renderizarse de forma nativa.
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 Prime Texto a video |
| Una imagen inicial aprobada fija sujeto y composición; la instrucción dirige el movimiento posterior. | Wan 3.0 Pro Prime Imagen a video |
| Referencias separadas pueden guiar identidad, lugar, movimiento o sonido con una función clara para cada una. | Wan 3.0 Pro Prime Referencias a video |
Funciones y aspectos destacados
El mismo cuerpo que Wan 3.0 Pro
prompt (hasta 20 000 caracteres) es el único campo obligatorio; resolution es 1080p por defecto, aspect_ratio es adaptive y enable_prompt_expansion es true. Como el contrato es idéntico, un mismo cuerpo JSON funciona en Pro y en Pro Prime cambiando solo el nombre del modelo, así que envía un plano de prueba a ambos con la misma semilla antes de comprometer un proyecto con uno de ellos.
El encuadre, escrito en el brief
El ejemplo de la cripta dedica un tercio de su prompt solo al encuadre: la cabeza entera en cuadro, aire por encima del pelo, el cuadro cortado a la cintura y el rostro siempre visible. En un primer plano, el fallo habitual es que el modelo recorte la cara fuera de su propio cuadro, y nombrar el encuadre es la solución. La luz de las velas es la única principal, y el audio —llamas que titilan, una puerta de hierro a lo lejos— llega en la misma pasada.
Movimiento sin punto de apoyo
El ejemplo submarino no tiene suelo de referencia: un vestido de seda carmesí que se abre mientras el sujeto se hunde, el pelo abierto en abanico, burbujas que salen de las yemas de los dedos y una cámara que traza un arco e inclina a la vez. No indica resolución, así que usa el 1080p por defecto. Los planos en los que nada se asienta son los que más aprovechan un nivel de entrega mayor.
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.234 / segundo |
| $0.252 / segundo |
| $0.279 / segundo |
Casos de uso
Luz de color en movimiento en un cuadro vertical
El ejemplo de la aurora pide luz verde que recorre la piel y el pelo de dos personas que comparten una manta sobre un lago helado, en 9:16. La luz de color que se mueve sobre la piel es donde primero aparecen el banding y el ruido de color, así que encarga 2K o 4K para un sujeto así solo cuando la escena lo necesite de verdad; un sujeto estático en 4K solo te da un archivo más pesado.
Escenas con cámara en mano y luz disponible
El ejemplo del ferry nocturno es sencillo a propósito: encuadre documental con cámara en mano, un reflector de cubierta y las luces lejanas del puerto, dos hombres adultos en la barandilla de popa que juntan las frentes y se besan mientras la estela bulle abajo. No hay ninguna marca de contenido que definir, porque cada escena se envía como cualquier otro prompt; el consentimiento, los derechos, la edad y la ley local siguen siendo tu responsabilidad.
Guía de prompts y consejos prácticos
Explora en pequeño y entrega en grande
Ajusta el prompt en 1080p y 5 segundos con seed fijo. Cuando la toma funcione, reenvía exactamente el mismo cuerpo con resolution en 4k. Cambiar resolución y semilla a la vez cambia dos cosas de golpe y oculta cuál movió el resultado.
En un archivo ampliado, revisa primero la luz dura
Una sola fuente dura de noche —una bombilla colgante, un reflector de cubierta— es donde el material ampliado muestra antes sus límites: banding en la caída de luz, piel cerosa, tela mojada convertida en una mancha gris. Revisa esas zonas en el archivo 2K o 4K entregado antes de corregir color o montar una secuencia con él.
Cierra el texto antes del render final
En esta familia la expansión del prompt viene activada y reescribe los briefs detallados. Desactiva enable_prompt_expansion cuando el prompt ya se lea como una descripción precisa del plano, para que se ejecute la versión que ajustaste. Escribe el sujeto, una acción, un movimiento de cámara y después luz y sonido.
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-prime/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.
