Introduzione
Wan 3.0 Prime Immagine in video anima un frame iniziale per 2-30 secondi con il render Prime, con gli stessi campi di Wan 3.0 Immagine in video. image_url è obbligatorio e diventa esattamente il primo frame; il prompt è facoltativo e deve descrivere solo il movimento; last_image_url fissa facoltativamente il frame finale. La risoluzione è 480p, 720p o 1080p, con 720p come predefinita, e l’audio viene generato con l’immagine a meno che tu non imposti generate_audio su false.
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 Prime Testo in video |
| Un’immagine iniziale approvata fissa soggetto e composizione; l’istruzione dirige il movimento successivo. | Wan 3.0 Prime Immagine in video |
| Riferimenti distinti possono guidare identità, luogo, movimento o suono, con un ruolo esplicito per ciascuno. | Wan 3.0 Prime Riferimenti in video |
Caratteristiche principali
Set e abiti dall’immagine, azione dal prompt
Poiché il fotogramma fornisce già il look, l’intera richiesta può concentrarsi su azione e suono. L’esempio della sauna parte da un’immagine fissa che contiene già scena e abbigliamento; il suo prompt copre un mestolo d’acqua su pietre roventi, una nuvola di vapore, il dorso di un polso passato sulla clavicola e una riga audio che nomina il sibilo, il legno di cedro che scricchiola e un respiro lento.
Un finale fissato rende sicuri i cambiamenti lunghi
last_image_url fa terminare la clip esattamente su un’immagine fornita. L’esempio della pista da ballo parte da una pista vuota e finisce su un frame fornito di una sala piena, 10 secondi a 1080p e 3:4 senza audio: il modello inventa come si riempie la sala, non con cosa finisce piena.
Per impostazione predefinita, la forma del frame
Se ometti aspect_ratio, la clip conserva la forma del frame iniziale; un valore in contrasto lo ritaglia. Sono accettati JPEG, PNG senza trasparenza, BMP o WEBP, da 240 a 8000 pixel per lato, fino a 20 MB e non più larghi di 8:1. Il frame finale segue gli stessi limiti.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | No | Opzionale: senza di esso il modello anima da solo il fotogramma iniziale. Quando lo scrivi, descrivi l'inquadratura: soggetto, un'azione, un movimento di camera, poi luce e suono. almeno 1 caratteri |
image_url | Sì | Il fotogramma iniziale, usato esattamente come primo fotogramma, e il vero tetto di qualità dell'inquadratura. |
last_image_url | No | Facoltativo, e solo insieme a |
aspect_ratio | No | 16:9, 9:16, 1:1, 4:3, 3:4 oppure adaptive, che lascia scegliere al modello. Omettilo per ereditare la forma del fotogramma iniziale; un valore in conflitto ritaglia. |
enable_thinking | No | Fa ragionare il modello sulla richiesta e sul materiale di riferimento prima di generare. Predefinito: |
resolution | No | 480p, 720p o 1080p. Predefinito 720p. |
duration_seconds | No | Qualsiasi numero intero da 2 a 30, oppure -1 per la durata intelligente, in cui è il modello a scegliere la lunghezza: il massimo di 30 secondi viene riservato in anticipo e l'a… |
generate_audio | No | Attivo per impostazione predefinita. Il clip torna con il suono già agganciato all'immagine. Predefinito: |
enable_prompt_expansion | No | Disattivo per impostazione predefinita. Quando è attivo, il prompt viene riscritto prima della generazione: aiuta con i brief scarni e ti contrasta su quelli dettagliati. Predefinito: |
seed | No | Da 0 a 2147483647. Tienilo fermo per confrontare un campo alla volta; toglilo per avere varietà. |
Prezzi
| Specifiche | Prezzo |
|---|---|
| $0.0612 / secondo |
| $0.126 / secondo |
| $0.252 / secondo |
Casi d’uso
Azione veloce da un’immagine fissa
L’esempio della spiaggia parte da un’amazzone a cavallo e chiede che il galoppo corto si apra in galoppo pieno, che sabbia e acqua bassa schizzino dietro gli zoccoli e che una carrellata veloce la affianchi mentre passa verso un sole basso. A quella velocità il frame iniziale smette di aiutare, quindi è il prompt a reggere la fisica: cosa viene sollevato, in quale direzione e come la camera tiene il passo.
Un solo gesto con il finale fissato
L’esempio del ballo in maschera fissa entrambi gli estremi — un primo e un ultimo frame forniti della stessa donna sulla stessa scalinata di marmo — e descrive l’ingresso tra i due: si toglie la maschera d’oro, raccoglie l’abito e scende qualche gradino verso la camera mentre gli ospiti mascherati alzano i calici. Poiché il fotogramma finale è stato ricavato da quello iniziale, abito, lampadario e ospiti restano al loro posto. Dura 5 secondi a 720p, con audio.
Consigli avanzati
Approva prima il frame d’arrivo come immagine
Quando il finale conta, crea l’ultimo frame prima del render, sullo stesso set e con la stessa inquadratura del primo. Approvarlo come immagine fissa costa molto meno che iterare su un lungo tratto centrale, e il compito del prompt diventa descrivere una transizione invece di inventare una destinazione.
Scrivi il suono come un elenco di sorgenti
Il prompt della sauna termina con una riga "Audio:" che nomina ogni sorgente. È più affidabile di una parola d’atmosfera e lega ogni suono all’azione che lo produce. Imposta generate_audio su false, come nell’esempio della pista da ballo, quando la clip verrà sonorizzata al montaggio.
Fissa corto, poi allunga
Prova il movimento a 5 secondi con seed fisso, poi allunga. Le clip lunghe derivano di più in identità e geometria, e gli incroci rapidi di braccia e gambe a 30 secondi sono il punto in cui compaiono per primi gli artefatti. Lascia enable_prompt_expansion sul valore predefinito false, così un brief di movimento preciso non viene riscritto prima della generazione.
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-prime/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p"
}
}'
# 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.
