Introduzione
Wan 2.2 immagine in video parte da un'immagine che fornisci tu e anima ciò che succede dopo. Due input sono obbligatori: un fotogramma iniziale in JPEG, PNG o WebP fino a 10 MB e un prompt fino a 5.000 caratteri che descrive il movimento. Ogni richiesta restituisce un unico clip muto di cinque secondi, a 480p (il valore predefinito) o a 720p.
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
L'aspetto lo decide l'immagine
Soggetto, costumi, scenografia e direzione della luce arrivano tutti dall'immagine iniziale, quindi il prompt non deve descriverli di nuovo. È questo che rende la modalità adatta al materiale che deve combaciare con un riferimento: nell'esempio del flacone di siero l'immagine fissa etichetta e silhouette, e il prompt chiede solo un arco di camera e una luce in movimento.
Il formato arriva dall'immagine
Questo endpoint non ha un'impostazione del formato. Le proporzioni più sicure sono 16:9 e 9:16, perché un'immagine con proporzioni diverse può tornare ridimensionata e ritagliata al centro. Ritaglia l'immagine nel formato di consegna prima di caricarla.
Durata fissa, solo immagine
Ogni ripresa è di cinque secondi di video senza suono, e né la durata né l'audio si possono cambiare. Con questi due elementi fissi, il movimento è l'unica variabile: per questo ogni esempio pubblicato chiede un solo movimento o un solo rapporto di causa ed effetto.
L'espansione del prompt cambia più della formulazione
L'espansione del prompt è disattivata per impostazione predefinita. Se la attivi può cambiare l'aspetto del render, non solo il testo dell'indicazione, quindi confrontala con un'esecuzione senza espansione prima di tenerla. L'esempio del campanello a vento e della figura la lascia disattivata perché la frase venga eseguita esattamente come è scritta.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
image_url | Sì | Il fotogramma iniziale: JPEG, PNG o WebP, fino a 10 MB. Soggetto, abbigliamento, ambiente e direzione della luce vengono tutti da lì, quindi ritaglialo prima. almeno 1 caratteri |
prompt | Sì | Obbligatorio, fino a 5.000 caratteri. Che cosa succede dopo il fotogramma: un'azione e un comportamento di camera. almeno 1 caratteri · al massimo 5000 caratteri |
negative_prompt | No | Ciò che non deve comparire: una seconda persona, sottotitoli, un oggetto di scena che il modello continua a riportare dentro. Scrivi un semplice elenco invece di frasi negative. al massimo 500 caratteri |
resolution | No | 480p o 720p, predefinito 480p. È l'unica impostazione che cambia il prezzo. |
enable_prompt_expansion | No | Disattivo per impostazione predefinita. Attivalo per un'idea di una riga; lascialo spento quando il prompt è già un'azione precisa. Predefinito: |
seed | No | Da 0 a 2147483647. Fissalo quando confronti 480p e 720p a partire dallo stesso fotogramma; per un valore casuale ometti il campo invece di inviare 0. |
Prezzi
Ogni richiesta restituisce una clip di cinque secondi.
| Specifiche | Prezzo |
|---|---|
| $0.24 / richiesta |
| $0.48 / richiesta |
Casi d’uso
Dare movimento a una foto di prodotto
Invia un packshot approvato e chiedi un movimento di camera o un cambio di luce, lasciando il prodotto al suo posto. L'esempio del flacone di siero mostra lo schema: la camera compie lentamente un quarto di giro attorno a un flacone contagocce, una morbida striscia di luce da finestra scorre sul vetro, e il prompt specifica che il flacone in sé non si muove.
Un solo momento di recitazione da un ritratto
L'esempio dello slip dress parte da un ritratto in studio e chiede una sola azione: lei sposta il peso, gira le spalle verso l'obiettivo, fa due passi lenti e mantiene lo sguardo. La camera è fissa, lo sfondo grigio dello studio resta intatto e la ripresa è renderizzata a 720p.
Un movimento con una causa visibile
Nell'esempio del campanello a vento e della figura, un campanello a vento gira e una forma dietro una tenda di garza si muove con lui, mentre l'ombra della tenda attraversa la scena. Scrivere causa ed effetto in un clip breve e muto dà una ragione al movimento e gli evita di sembrare un loop.
Consigli avanzati
Prepara l'immagine prima del prompt
Ritaglia l'immagine in 16:9 o 9:16 e verifica che mostri già i costumi, la scenografia e la luce che vuoi, perché il prompt non è il posto per cambiarli. Togli sovrapposizioni o soggetti di troppo che non vuoi animare e tieni il file sotto i 10 MB.
Descrivi solo ciò che succede dopo il fotogramma iniziale
Indica chi o che cosa si muove, in quale direzione e con quale ritmo, e poi il comportamento della camera. Descrivere di nuovo oggetti già visibili consuma caratteri senza aggiungere movimento. Vale invece la pena una frase su ciò che deve restare fermo, come il flacone che non si muove.
Bozza a 480p, consegna a 720p
La risoluzione è l'unica impostazione che cambia il prezzo. Fissa un seed tra 0 e 2147483647 quando confronti una bozza a 480p con la sua nuova versione a 720p dalla stessa immagine. Per un risultato casuale ometti il seed invece di inviare 0.
Rivedi tutto il clip prima di ampliare l'azione
Guarda l'inizio, il movimento più ampio e l'ultimo secondo. Se un volto, un'etichetta o un contorno si deforma, riduci il numero di movimenti simultanei prima di riscrivere il prompt. Quando l'inquadratura successiva richiede un'altra composizione, riparti da un'immagine nuova invece di chiedere al movimento di arrivarci.
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/image-to-video",
"input": {
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "480p"
}
}'
# 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.




























