Guida all'API Wan 3.0: modelli, input e primo video
Confronta gli input API e le specifiche di output di Wan 3.0, Wan 3.0 Prime, Wan 3.0 Pro e Wan 3.0 Prime Pro e prepara il tuo primo test video.
La prima decisione nell'integrazione dell'API Wan 3.0 riguarda il materiale su cui il modello deve lavorare: una scena scritta, un'immagine iniziale o una serie di riferimenti. Alibaba Cloud descrive Wan 3.0 come un modello video capace di generare fino a 30 secondi in un solo passaggio e di accettare testo, immagini, audio, video e documenti. 1
Questa guida spiega le opzioni disponibili e come preparare una prima prova. Descrive le capacità del modello a monte; l'endpoint di produzione di Wan API e i dettagli per ottenere le chiavi saranno pubblicati nella documentazione di integrazione. Le tariffe dei modelli sono riportate nella pagina dei prezzi. Ogni modello elencato qui sotto ha una pagina dedicata alle specifiche.
Capire i nomi dei modelli
Wan 3.0 è la famiglia di modelli. L'integrazione ufficiale di Comfy elenca anche wan3.0-video-prime tra i modelli selezionabili. Questo conferma che Prime è un'opzione distinta, ma il nome assegnato da un fornitore non definisce da solo lo schema della richiesta, la disponibilità su un altro servizio o i tempi di risposta che otterrà la tua applicazione. 2
| Nome | Cosa verificare prima dell'integrazione |
|---|---|
| Wan 3.0 | Flussi con testo, immagini e riferimenti; output in 480p, 720p e 1080p |
| Wan 3.0 Prime | Un modello Prime distinto con tariffe proprie; output fino a 1080p |
| Wan 3.0 Pro | L'opzione Pro documentata per output in 1080p, 2K e 4K |
| Wan 3.0 Prime Pro | Un'opzione Prime Pro distinta con impostazioni 1080p, 2K e 4K |
Prime e Pro sono varianti distinte: confronta le risoluzioni disponibili e l'identificatore esatto del modello prima di scegliere. Wan 3.0 e Prime supportano output fino a 1080p; Pro e Prime Pro aggiungono le opzioni 2K e 4K.
Per un confronto utile, invia lo stesso prompt e gli stessi riferimenti mantenendo identiche durata e risoluzione. Annota il tempo di completamento, il costo e se il risultato soddisfa il brief. L'etichetta del modello non sostituisce questa prova.
Scegli l'input adatto al tuo materiale
Comfy documenta tre flussi per Wan 3.0: da testo a video, da immagine a video e da riferimenti a video. Il flusso con immagini accetta un primo fotogramma e un ultimo fotogramma facoltativo. Il flusso con riferimenti usa immagini, video e audio, con tag come @Image1, @Video1 e @Audio1 per descrivere il ruolo di ogni input. Questi nomi e tag appartengono a quella specifica integrazione; usa i campi documentati dal tuo fornitore API. 2
| Materiale di partenza | Una prima prova pratica |
|---|---|
| Una scena scritta | Descrivi un soggetto, un'azione e un movimento di camera |
| La fotografia di un prodotto | Spiega il movimento e indica quali dettagli devono restare coerenti |
| Più riferimenti | Assegna un ruolo a ciascuno: identità, aspetto del prodotto, movimento o audio |
| Una presentazione o un documento | Parti da una sezione breve con un pubblico e un messaggio chiari |
L'input documentale di Alibaba supporta un file o un link, con file fino a 100 MB. Il limite di 50 pagine si applica ai file PDF, DOCX, DOC, PPTX, PPT, KEY e PAGES. Un gateway potrebbe esporre meno modalità di input: verifica quindi il supporto dei documenti prima di costruirci attorno un flusso di caricamento. 1
Rendi facile valutare la prima prova
Parti da una clip breve e da impostazioni di output esplicite. Ad esempio, prova una ripresa di prodotto di cinque secondi con un movimento lento di camera e senza dialoghi. Questo è un brief di prova suggerito, non un payload API:
Una tazza da caffè in ceramica è accanto a una finestra nella luce soffusa del mattino. La camera si avvicina lentamente alla tazza mentre sale il vapore. Mantieni coerenti forma e colore della tazza. Usa suoni ambientali di una stanza tranquilla, senza parlato.
Imposta consapevolmente durata, risoluzione, proporzioni e audio dove il fornitore lo consente. L'attuale flusso Wan di Comfy include l'audio per impostazione predefinita e offre output in 480p, 720p e 1080p. Queste impostazioni documentate sono un utile punto di partenza, ma non garantiscono che ogni endpoint Wan esponga gli stessi controlli. 2
Valuta il risultato in base a ciò che serve davvero alla tua applicazione: coerenza del soggetto, movimento richiesto, audio e composizione utilizzabile. Alibaba indica la resa dell'audio e l'accuratezza del testo a schermo come aspetti ancora in fase di perfezionamento: controlla quindi parlato e scritte generati prima di usare un risultato in produzione. 1
Verifica le specifiche dell'API prima di costruire il flusso
Prima di collegare un'applicazione in produzione, verifica nella documentazione del fornitore l'ID esatto del modello, il metodo di autenticazione, i formati multimediali accettati, il flusso di invio delle attività e recupero dei risultati, la gestione degli errori e le regole di fatturazione. Mantieni questi dettagli separati dal prompt creativo.
Per Wan API, parti dalla panoramica dei modelli. La prima tappa dell'integrazione dovrebbe essere una richiesta autenticata riuscita all'endpoint pubblicato; la pagina di presentazione, da sola, non è una specifica API.
Fonti
- Alibaba Cloud, Wan3.0: 30-Second AI Video Generation from Any Input. Pubblicato il 13 agosto 2026; verificato il 13 ottobre 2026.
- Comfy, Wan 3.0 Video Generation in ComfyUI. Verificato il 13 ottobre 2026. Le impostazioni citate descrivono l'integrazione di Comfy.
Novità di Wan API
Accesso API e aggiornamenti dei modelli
Iscriviti per ricevere un’email quando verrà aperto l’accesso a Wan API e aggiornamenti sui modelli Wan.