Introduzione
Wan 2.6 Immagine in video parte dal fotogramma che invii in image_url e restituisce esattamente 5, 10 o 15 secondi a 720p o 1080p, con audio. Il fotogramma fissa soggetto, costumi, set, direzione della luce e proporzioni della clip. Il prompt è facoltativo e contiene fino a 1.500 caratteri: un’azione per una ripresa singola, oppure inquadrature numerate per un montaggio a più inquadrature.
Scegli il metodo in base al materiale di partenza
| Da cosa parti | Metodo |
|---|---|
| una scena o una sceneggiatura scritta | Wan 2.6 Testo in video |
| un’immagine iniziale approvata | Wan 2.6 Immagine in video |
| riferimenti separati per aspetto, movimento o suono | Wan 2.6 Riferimenti in video |
Caratteristiche principali
Il fotogramma decide formato e aspetto
Non esiste un campo per il formato: la clip mantiene le proporzioni dell’immagine che invii, quindi una consegna 9:16 comincia con un ritaglio 9:16. Il fotogramma può essere JPEG, PNG senza trasparenza, BMP o WEBP, da 240 a 8.000 pixel per lato e non oltre 20 MB. Tutto ciò che vi compare è già deciso, e il prompt resta libero di descrivere il movimento.
Copertura tagliata da un solo fotogramma
Con shot_type impostato su multi, il modello può tagliare tra angolazioni diverse mantenendo il look del fotogramma iniziale, così una clip di quindici secondi può contenere un campo lungo, un dettaglio e un finale invece di un unico movimento di camera che deriva. Una richiesta multi gira sempre con l’espansione del prompt attiva. Resta su single per rotazioni di prodotto, mezzi busti che parlano e tutto ciò che deve restare continuo, perché multi rompe la continuità per scelta.
Audio generato o fornito da te
La clip torna con un audio generato nello stesso passaggio dell’immagine. Perché parlato o accenti musicali cadano dove te li aspetti, invia audio_url: WAV o MP3, da 3 a 30 secondi, fino a 15 MB. Una traccia più lunga viene tagliata alla durata della clip; con una più corta, il resto della clip resta muto.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
image_url | Sì | Il fotogramma iniziale. Soggetto, abiti, set, direzione della luce e proporzioni della clip vengono da qui, quindi ritaglialo prima. |
prompt | No | Facoltativo. Un'azione sola per una ripresa continua, oppure inquadrature numerate per un montaggio. almeno 1 caratteri · al massimo 1500 caratteri |
negative_prompt | No | Ciò che non deve comparire: una seconda persona, sottotitoli, un oggetto di scena che il fotogramma continua a riportare dentro. Al massimo 500 caratteri. al massimo 500 caratteri |
resolution | No | 720p o 1080p, predefinita 720p. Fissa la tariffa al secondo e il tempo di elaborazione. |
duration_seconds | No | Esattamente 5, 10 o 15. I montaggi su più inquadrature hanno bisogno delle durate lunghe per respirare. |
audio_url | No | Una battuta parlata o un attacco musicale che la clip deve seguire, così voce e accenti cadono dove te li aspetti. WAV o MP3, da 3 a 30 secondi, al massimo 15 MB. |
shot_type | No | single mantiene una ripresa continua; multi lascia che il modello stacchi tra le inquadrature: ottimo per le storie brevi, ma a costo della continuità. |
enable_prompt_expansion | No | Disattivata per impostazione predefinita. Attivandola, un'idea di una riga diventa una scaletta di inquadrature per multi; lasciala spenta se il prompt è già preciso. Predefinito: |
seed | No | Da 0 a 2147483647. Tienilo fermo quando confronti single e multi partendo dallo stesso fotogramma. |
Prezzi
| Specifiche | Prezzo |
|---|---|
| $0.09 / secondo |
| $0.135 / secondo |
Casi d’uso
Una macro di prodotto che non deve saltare
L’esempio del siero anima la foto di un flacone con contagocce per cinque secondi a 1080p con un seed fisso. Una sola goccia cade dalla punta del contagocce, anelli si allargano sul liquido e la fascia di luce sul vetro si schiarisce un poco, il tutto con inquadratura macro bloccata e un leggero tintinnio di vetro. Resta una ripresa singola perché un’inquadratura di prodotto non deve tagliare tra angolazioni.
Una breve storia d’interni da una sola foto
L’esempio dell’appartamento la sera dura 15 secondi a 720p, con shot_type su multi ed espansione del prompt attiva. Un solo fotogramma d’interni fornisce tre inquadrature: la lampada tremola mentre fuori si accendono le luci della città, una coperta piegata scivola dalla poltrona e la porta d’ingresso si apre versando la luce del corridoio sul parquet, su un tono d’ambiente tranquillo e traffico lontano.
Un personaggio che pronuncia la tua battuta
Abbina l’immagine di un personaggio a una battuta registrata in audio_url, così il parlato cade dove te lo aspetti invece di diventare un movimento generico. I mezzi busti che parlano vanno su single, e conviene controllare tutta la durata: se la traccia è più corta della clip, la parte restante è muta.
Consigli avanzati
Prepara il fotogramma prima di scrivere una parola
Ritaglia al formato di consegna e verifica che il fotogramma mostri già costumi, set e luce che vuoi, perché nessun prompt salva un primo fotogramma sbagliato. Togli scritte sovrapposte o un secondo soggetto che non vuoi animare, e usa negative_prompt, fino a 500 caratteri, per ciò che il fotogramma continua a riportare, come un oggetto di scena o un testo a schermo.
Descrivi il movimento, non ciò che si vede già
Per una ripresa singola scrivi un’azione e un movimento di camera. Il prompt del siero nomina la goccia, gli anelli, il cambiamento della fascia di luce, l’inquadratura e un suono, e non dice nulla della forma del flacone né dell’etichetta, perché il fotogramma li contiene già.
A single drop falls from the dropper tip into the bottle and sends slow rings across the liquid surface; the light band on the glass brightens a little. Locked macro framing, soft chime of glass.
Pianifica un montaggio a più inquadrature
Scrivi inquadrature numerate, ognuna con il proprio taglio, e scegli 10 o 15 secondi perché i tagli abbiano spazio. Scegliere multi attiva enable_prompt_expansion per quella richiesta. Per una ripresa singola resta disattivato per impostazione predefinita, e un prompt preciso viene inviato esattamente come l’hai scritto.
Confronta single e multi dallo stesso fotogramma
Fissa seed, che accetta valori da 0 a 2147483647, lascia invariati fotogramma e prompt, ed esegui la richiesta una volta come single e una come multi per capire quale serve meglio l’inquadratura. La risoluzione determina la tariffa al secondo e la durata dell’elaborazione, quindi metti a punto il testo a 720p prima di renderizzare a 1080p. Un seed fisso stabilizza il confronto senza promettere una ripetizione identica fotogramma per fotogramma.
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.6/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"resolution": "720p",
"shot_type": "single"
}
}'
# 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.




























