Introduzione
Wan 2.2 testo in video genera un clip partendo solo da un prompt scritto. Ogni richiesta restituisce un unico video muto di cinque secondi, in 16:9 o 9:16, renderizzato a 480p o 720p. Il prompt può arrivare a 5.000 caratteri ed è l'unico campo obbligatorio: il formato predefinito è 16:9, la risoluzione 480p, e l'espansione del prompt resta disattivata finché non la attivi.
Scegli la modalità Wan 2.2 in base al materiale di partenza
| Cosa hai all'inizio | Modalità | Cosa serve alla richiesta |
|---|---|---|
| una scena scritta o una sceneggiatura | Wan 2.2 testo in video | un prompt; 16:9 o 9:16 |
| un'immagine fissa da mantenere | Wan 2.2 immagine in video | un'immagine e un prompt; il formato lo decide l'immagine |
Caratteristiche principali
Una ripresa fissa di cinque secondi
Il testo in video non ha un'impostazione di durata: ogni ripresa dura esattamente cinque secondi, quindi conosci la lunghezza di una richiesta prima di inviarla. In cinque secondi sta un solo momento (un soggetto, un'azione e un movimento di camera), non una sequenza di eventi. I prompt scritti su questa misura sono quelli che danno i risultati più affidabili.
Due formati e due risoluzioni
Il formato predefinito è 16:9, oppure 9:16 per la pubblicazione verticale. Inquadrature quadrate e 4:3 non sono disponibili: per una consegna quadrata genera in 16:9 e ritaglia in montaggio. La risoluzione è 480p o 720p ed è l'unica impostazione che cambia il prezzo, per cui 480p è il livello naturale per le bozze.
Solo immagine
I clip arrivano senza traccia audio e non esiste alcuna impostazione del suono. Tutto ciò che lo spettatore deve percepire va reso visibile: l'esempio pubblicato del binario innevato costruisce il ritmo con la neve che cade, il respiro che si condensa nel freddo e una lampada del binario che tremola, invece di affidarsi all'atmosfera sonora.
Espansione del prompt e seed facoltativi
L'espansione del prompt riscrive un'indicazione breve in una versione più completa prima della generazione. Il seed accetta valori da 0 a 2147483647 e tiene ferma la sorgente casuale, così puoi confrontare una modifica alla volta; non garantisce un clip identico fotogramma per fotogramma a una seconda esecuzione.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | L'inquadratura vera e propria, fino a 5.000 caratteri: chi, un'azione, un movimento di camera, poi la luce. Un verbo chiaro sposta il risultato più di una pila di aggettivi. almeno 1 caratteri · al massimo 5000 caratteri |
aspect_ratio | No | 16:9 o 9:16, predefinito 16:9. Su questo endpoint non c'è l'opzione quadrata né 4:3. |
resolution | No | 480p o 720p, predefinito 480p. È l'unica impostazione che cambia il prezzo. |
enable_prompt_expansion | No | Disattivo per impostazione predefinita. Predefinito: |
seed | No | Da 0 a 2147483647. Tienilo fermo mentre confronti una modifica alla volta; toglilo per avere varietà. |
Prezzi
Ogni richiesta restituisce una clip di cinque secondi.
| Specifiche | Prezzo |
|---|---|
| $0.24 / richiesta |
| $0.48 / richiesta |
Casi d’uso
Bozze di storyboard in serie
Scrivi ogni momento dello storyboard come un prompt a sé e renderizza l'intero elenco a 480p. Cinque secondi bastano per valutare inquadratura e movimento e, dato che ogni richiesta ha la stessa durata e il prezzo dipende solo dalla risoluzione, conosci il costo del lotto prima di inviarlo. Le riprese che tieni rigenerale a 720p con lo stesso prompt e lo stesso seed.
Clip verticali per i social
Imposta il formato su 9:16 e descrivi una sola azione continua. L'esempio pubblicato del mercato notturno fa proprio questo a 720p: una giovane donna con un impermeabile giallo prende uno spiedino da una bancarella alla griglia, fumo e vapore salgono tra fili di lampadine, poi lei si gira e cammina verso la camera, che si avvicina lentamente a mano.
Verificare se un'idea di inquadratura regge in movimento
Prima di passare a una ripresa a 720p puoi provare l'idea spendendo poco. L'esempio della scala del faro è scritto come un'azione e una posizione di camera (un uomo anziano con una lanterna sale l'ultima rampa di una scala a chiocciola mentre una camera bassa lo segue) ed è renderizzato in 16:9 a 480p.
Consigli avanzati
Scrivi un solo momento in un ordine fisso
Indica il soggetto, l'unica azione, un movimento di camera e infine la luce. Un verbo chiaro sposta il risultato più di una fila di aggettivi: un uomo che sale l'ultima rampa di una scala e si ferma davanti a una finestra dà al clip un inizio e una fine entro cinque secondi.
Usa i caratteri per i dettagli, non per altre scene
Il limite di 5.000 caratteri lascia spazio per costumi, scenografia, meteo e luce, ma cinque secondi non reggono un secondo evento. Se un'indicazione ne contiene diversi, dividili in richieste separate e uniscili in montaggio.
Tieni fermo il seed mentre correggi
Scegli un seed e mantienilo mentre cambi una sola cosa, per esempio un verbo, il movimento di camera o il formato. L'esempio del mercato notturno fissa il seed 250728 perché la stessa inquadratura si possa confrontare tra una versione del prompt e l'altra. Ometti il seed quando cerchi varietà.
Decidi presto sull'espansione del prompt
Se hai solo un'idea di una riga, attivando l'espansione del prompt il servizio scrive per te un'indicazione più completa. Quando il tuo prompt nomina già soggetto, azione, camera e luce, lasciala disattivata perché il testo venga eseguito così com'è, e valuta sempre una versione espansa confrontandola con una senza espansione.
Capisci quando il testo non basta
Un prompt da solo non mantiene stabile un volto o un prodotto preciso da un'esecuzione all'altra. Quando il soggetto deve corrispondere a un'immagine fissa approvata, passa a Wan 2.2 immagine in video e lascia che sia l'immagine a definire l'aspetto.
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-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"
Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.




























