Introduzione
Wan 3.0 Pro Prime Testo in video genera un’inquadratura da 2 a 30 secondi da un prompt e la consegna a 1080p, 2K o 4K con l’audio nello stesso file. L’elenco dei campi coincide esattamente con quello di Wan 3.0 Pro Testo in video, ma il render di base è Wan 3.0 Prime, che Alibaba presenta come la versione ad alta velocità con le stesse capacità. Un render nativo di Prime arriva al massimo a 1080p, quindi i livelli 2k e 4k sono ingranditi da esso invece che renderizzati in modo nativo.
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 Prime Testo in video |
| Un’immagine iniziale approvata fissa soggetto e composizione; l’istruzione dirige il movimento successivo. | Wan 3.0 Pro Prime Immagine in video |
| Riferimenti distinti possono guidare identità, luogo, movimento o suono, con un ruolo esplicito per ciascuno. | Wan 3.0 Pro Prime Riferimenti in video |
Caratteristiche principali
Lo stesso body di Wan 3.0 Pro
prompt (fino a 20.000 caratteri) è l’unico campo obbligatorio; resolution vale 1080p per impostazione predefinita, aspect_ratio vale adaptive e enable_prompt_expansion vale true. Poiché il contratto è identico, un unico body JSON funziona su Pro e su Pro Prime cambiando solo il nome del modello: invia un’inquadratura di prova a entrambi con lo stesso seed prima di legare un progetto a uno dei due.
L’inquadratura scritta nel brief
L’esempio della cripta dedica un terzo del prompt alla sola inquadratura: tutta la testa nel quadro, aria sopra i capelli, il quadro tagliato in vita, il volto sempre visibile. In un primo piano l’errore tipico è che il modello tagli il volto fuori dal proprio quadro, e nominare l’inquadratura è il rimedio. La luce delle candele è l’unica principale, e l’audio — fiamme che tremolano, una porta di ferro lontana — arriva nello stesso passaggio.
Movimento senza punto d’appoggio
L’esempio subacqueo non ha un fondo di riferimento: un abito di seta cremisi che si apre mentre il soggetto affonda, capelli aperti a ventaglio, bolle che partono dalle punte delle dita e una camera che traccia un arco e si inclina insieme. Non indica una risoluzione, quindi usa i 1080p predefiniti. Le inquadrature in cui nulla si posa sono quelle che traggono più vantaggio da un livello di consegna più grande.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Soggetto, una sola azione, un solo movimento di camera, poi luce e suono. In 4K un brief vago costa denaro vero: scrivi l'inquadratura, non l'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 oppure adaptive. Di default è 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 di default. Il suono viene generato insieme alle immagini e arriva dentro lo stesso file. Predefinito: |
enable_prompt_expansion | No | Attivo di default su questa famiglia. Completa i brief scarni e riscrive quelli dettagliati, quindi disattivalo appena il tuo prompt è una descrizione precisa dell'inquadratura. Predefinito: |
seed | No | Da 0 a 2147483647. Tienilo fisso mentre regoli risoluzione o durata, altrimenti ogni ripetizione cambia due cose insieme. |
Prezzi
| Specifiche | Prezzo |
|---|---|
| $0.234 / secondo |
| $0.252 / secondo |
| $0.279 / secondo |
Casi d’uso
Luce colorata in movimento in un quadro verticale
L’esempio dell’aurora chiede una luce verde che scorre su pelle e capelli di due persone che condividono una coperta su un lago ghiacciato, in 9:16. La luce colorata che si muove sulla pelle è il punto in cui banding e rumore cromatico compaiono per primi, quindi richiedi 2K o 4K per un soggetto simile solo quando la scena ne ha davvero bisogno; un soggetto statico in 4K ti dà solo un file più pesante.
Scene a mano con luce disponibile
L’esempio del traghetto notturno è volutamente semplice: inquadratura documentaristica a mano, un faro di coperta e le luci lontane del porto, due uomini adulti al parapetto di poppa che avvicinano le fronti e si baciano mentre la scia ribolle sotto di loro. Non c’è nessun flag di contenuto da impostare, perché ogni scena si invia come qualsiasi altro prompt; consenso, diritti, età e legge locale restano sotto la tua responsabilità.
Consigli avanzati
Esplora in piccolo, consegna in grande
Metti a punto il prompt a 1080p e 5 secondi con seed fisso. Quando la ripresa funziona, invia di nuovo lo stesso identico body con resolution su 4k. Cambiare risoluzione e seed insieme cambia due cose in una volta e nasconde quale delle due ha spostato il risultato.
In un file ingrandito, controlla prima la luce dura
Una sola sorgente dura di notte — una lampadina appesa, un faro di coperta — è dove il materiale ingrandito mostra per primo i suoi limiti: banding nella caduta di luce, pelle cerosa, tessuto bagnato che diventa una macchia grigia. Controlla queste zone nel file 2K o 4K consegnato prima della color correction o del montaggio di una sequenza.
Blocca il testo prima del render finale
In questa famiglia l’espansione del prompt è attiva per impostazione predefinita e riscrive i brief dettagliati. Disattiva enable_prompt_expansion quando il prompt si legge come una descrizione precisa dell’inquadratura, così viene eseguita la versione messa a punto. Scrivi il soggetto, un’azione, un movimento di camera, poi luce e suono.
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-prime/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.



























