Introduzione
Wan 3.0 Pro Testo in video scrive un’inquadratura da un prompt e la consegna a 1080p, 2K o 4K per 2-30 secondi, con l’audio generato nello stesso file. prompt è l’unico campo obbligatorio e accetta fino a 20.000 caratteri. Un render nativo di Wan 3.0 arriva al massimo a 1080p, quindi i livelli 2k e 4k sono ingranditi da quel render e non disegnati a quelle dimensioni. Questo endpoint non ha livelli 480p né 720p: quelle dimensioni sono coperte da Wan 3.0.
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
Tre dimensioni di consegna da un unico render nativo
resolution accetta 1080p (predefinito), 2k o 4k. I due livelli maggiori allungano ciò che il modello ha disegnato invece di disegnare di più: sono adatti a materiale che verrà ritagliato, tracciato o proiettato, e valgono quanto il render sottostante. Trova l’inquadratura prima a 1080p e considera il 4K una fase di consegna.
L’espansione del prompt parte attiva
In questa famiglia enable_prompt_expansion vale true per impostazione predefinita. Arricchisce un brief scarno, utile mentre stai ancora abbozzando, ma riscrive quello dettagliato. Quando il prompt descrive con precisione l’inquadratura, imposta il campo su false, così viene eseguita proprio la formulazione che hai messo a punto.
Formato adattivo finché non ne fissi uno
aspect_ratio vale adaptive per impostazione predefinita: il modello sceglie il quadro. Indica 16:9, 4:3, 1:1, 3:4 o 9:16 quando il formato di consegna è fissato: l’esempio della recinzione chiede 9:16 per un quadro verticale, mentre gli esempi del profumo, del bianco e nero e del tatuaggio fissano tutti 16:9.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Soggetto, un'azione, un movimento di macchina, poi luce e suono. In 4K un brief vago costa soldi veri, quindi scrivi l'inquadratura e non un'atmosfera. almeno 1 caratteri · al massimo 20000 caratteri |
resolution | No | 1080p, 2k o 4k, predefinito 1080p. |
aspect_ratio | No | 16:9, 4:3, 1:1, 3:4, 9:16 o adaptive. Il valore predefinito è adaptive, che lascia scegliere al modello; indica un rapporto quando il formato di consegna è fisso. |
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
Spot di profumi e beauty con luce dura
L’esempio del profumo è uno spot di cinque secondi al rallentatore: una donna adulta con un abito nero dalla schiena scoperta si volta da una finestra sferzata dalla pioggia mentre un’unica luce principale dura le scorre lungo la schiena e dai capelli saltano gocce, con una nota bassa di violoncello e pioggia in colonna sonora. Il tessuto lucido, una sola sorgente dura e le particelle piccole e veloci sono i primi a degradarsi con l’ingrandimento: controlla proprio quelli in una consegna 2K o 4K.
Tessuto mosso da un’unica forza esterna
Due esempi dirigono l’abito attraverso un’unica forza invece di descrivere come cade. Nel fashion film in bianco e nero, tre metri di chiffon di seta davanti a una macchina del vento industriale frustano intorno al corpo e si avvolgono attorno a una spalla sotto una luce dura su fondo nero. Nell’esempio della recinzione, il getto di un aereo in atterraggio schiaccia i vestiti di due persone contro il corpo. Nominare la forza dà al tessuto una causa da seguire.
Consigli avanzati
Esplora a 1080p, poi renderizza di nuovo il seed scelto
Trova l’inquadratura a 5 secondi e 1080p con seed fisso, cambia un campo per ripetizione e solo dopo invia lo stesso prompt con lo stesso seed e resolution su 4k. Cambiare risoluzione e testo nella stessa ripetizione rende impossibile capire quale dei due ha spostato il risultato.
Scrivi l’inquadratura, non un’atmosfera
Soggetto, un’azione, un movimento di camera, poi luce e suono. Il prompt dello studio di tatuaggi è un buon modello: candele e una lampada da scrivania come unica luce, mani guantate che ombreggiano un disegno sulle costole, una smorfia, un respiro lento e un sorriso da sopra la spalla, la macchinetta che ronza, un avvicinamento lentissimo. In 4K un brief vago è un modo costoso di scoprire cosa intendevi.
Nomina i suoni che vuoi sentire
Il suono viene generato con l’immagine, quindi elenca le sue sorgenti: lo spot del profumo chiede "low cello note and rain", il film con la macchina del vento "the roar of the fan and snapping cloth". Imposta generate_audio su false quando un compositore firma la colonna sonora. La famiglia accetta prompt senza censura senza dichiarazione per richiesta; consenso, diritti, età e legge locale di tutte le persone ritratte restano sotto la tua responsabilità.
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/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "1080p",
"aspect_ratio": "adaptive",
"duration_seconds": 5
}
}'
# 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.



























