Introduzione
Wan 3.0 Pro Immagine in video anima un frame iniziale e consegna la clip a 1080p, 2K o 4K per 2-30 secondi. image_url è l’unico campo obbligatorio e viene usato esattamente come primo frame, quindi guardaroba, corpo, set e luce arrivano dalla tua immagine; il prompt è facoltativo e dovrebbe occuparsi solo di movimento e camera. last_image_url fissa facoltativamente l’ultimo frame esatto e funziona solo insieme a image_url. L’audio viene generato con l’immagine, a meno che tu non lo disattivi.
Scegli il metodo in base al materiale di partenza
| Materiale di partenza | Metodo |
|---|---|
| Un brief scritto definisce scena, azione, camera e, quando serve, suono. | Wan 3.0 Pro Testo in video |
| Un’immagine iniziale approvata fissa soggetto e composizione; l’istruzione dirige il movimento successivo. | Wan 3.0 Pro Immagine in video |
| Riferimenti distinti possono guidare identità, luogo, movimento o suono, con un ruolo esplicito per ciascuno. | Wan 3.0 Pro Riferimenti in video |
Caratteristiche principali
Un render 4K non rende nitida un’immagine morbida
Il frame iniziale è il tetto di qualità dell’inquadratura, e i livelli 2k e 4k ingrandiscono un render nativo a 1080p senza disegnare nuovi dettagli. Una sorgente morbida o a bassa risoluzione resta morbida anche in 4K. Fornisci l’immagine più nitida che hai, in JPEG, PNG senza trasparenza, BMP o WEBP, da 240 a 8000 pixel per lato, fino a 20 MB e non più larga di 8:1.
Entrambi gli estremi fissati per master pronti al montaggio
L’esempio della bottiglia invia lo stesso packshot come image_url e last_image_url a 4k, con espansione del prompt e audio disattivati e un seed fisso, 5512090. La bottiglia ruota di un quarto di giro, il riflesso percorre tutta la lunghezza del vetro e torna all’angolo di partenza: un master la cui etichetta resta leggibile quando il montatore fa uno zoom digitale.
L’inquadratura segue la sorgente per impostazione predefinita
aspect_ratio vale adaptive per impostazione predefinita e segue il frame iniziale. Fissa 16:9, 4:3, 1:1, 3:4 o 9:16 solo quando il formato di consegna è stabilito. Nessuno dei quattro esempi pubblicati indica un rapporto, quindi ogni clip mantiene la forma della propria immagine sorgente.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | No | Qui è facoltativo, perché il fotogramma porta già l'aspetto. Usalo solo per il movimento e la macchina da presa. almeno 1 caratteri · al massimo 20000 caratteri |
image_url | Sì | Il fotogramma iniziale, usato esattamente come primo fotogramma, e il vero tetto di qualità dell'inquadratura. almeno 1 caratteri |
last_image_url | No | Facoltativo, e solo insieme a |
resolution | No | 1080p, 2k o 4k, predefinito 1080p. |
aspect_ratio | No | adaptive segue il fotogramma iniziale. Fissa 16:9, 4:3, 1:1, 3:4 o 9:16 solo quando il formato di consegna è obbligato. |
duration_seconds | No | Qualsiasi numero intero da 2 a 30, predefinito 5, oppure -1 per la durata intelligente, in cui è il modello a scegliere la lunghezza: il massimo di 30 secondi viene riservato in… |
generate_audio | No | Attivo per impostazione predefinita. Il suono viene generato insieme alle immagini e arriva dentro lo stesso file. Predefinito: |
enable_prompt_expansion | No | Attiva per impostazione predefinita su questa famiglia. Predefinito: |
seed | No | Da 0 a 2147483647. Fissalo mentre regoli risoluzione o durata, altrimenti ogni nuovo tentativo cambia due cose insieme. |
Prezzi
| Specifiche | Prezzo |
|---|---|
| $0.144 / secondo |
| $0.16 / secondo |
| $0.184 / secondo |
Casi d’uso
Lunghi percorsi con un arrivo approvato
L’esempio della vetta fornisce la base della montagna come image_url e la cima come last_image_url, poi renderizza 10 secondi in 4K con un prompt che copre solo la salita tra i due. Una lunga ascesa è proprio il punto in cui un finale non fissato deriva; fissare il frame d’arrivo ti permette di approvare il finale come immagine fissa prima di pagare un render 4K.
Il guardaroba resta nel frame
L'esempio della spalla di seta parte da un'immagine che contiene già l'abito, quindi il prompt dedica tutto al movimento: le spalle si girano lentamente verso la camera, la seta cattura la luce, il respiro si placa, un push-in lento con una luce principale dura da sinistra e pioggia sulla finestra alle spalle. Il render dura 5 secondi a 2k.
Consigli avanzati
Usa il prompt solo per movimento e camera
In questa famiglia l’espansione del prompt è attiva per impostazione predefinita e riscrive un brief di movimento dettagliato: imposta enable_prompt_expansion su false quando il testo è definitivo, come fa l’esempio della bottiglia. Poi indica chi si muove, di quanto e a che velocità, e cosa fa la camera. Il prompt accetta fino a 20.000 caratteri, ma un’azione chiara sposta il risultato più di un lungo elenco.
Approva a 1080p, poi renderizza in grande
Definisci inquadratura e movimento a 5 secondi e 1080p con seed fisso; una ripetizione che cambia sia risoluzione sia seed cambia due cose insieme. Quando entrambi i frame sono approvati e il movimento si legge bene, invia di nuovo lo stesso body a 2k o 4k. La durata va da 2 a 30 secondi interi, oppure -1 per lasciare la scelta al modello.
Controlla i dettagli ingranditi nel file consegnato
In un file 2K o 4K controlla prima le zone che l’ingrandimento stira: il testo dell’etichetta, i riflessi speculari duri, la texture di capelli e pelle. L'esempio dello specchio appannato è un caso impegnativo: il vapore che sale e appanna uno specchio, la figura girata lontano dall'obiettivo, un push-in lento oltre un applique a parete, reso in 4k tra un primo e un ultimo fotogramma bloccati.
Avvio rapido dell’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/image-to-video",
"input": {
"aspect_ratio": "adaptive",
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"resolution": "1080p"
}
}'
# 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"
Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.
