Alibaba
Wan 3.0 Video
wan3.0-video-prime
Nuova generazione di modelli di generazione video della serie Wan di Alibaba, in grado di produrre in un'unica generazione clip da circa 30 secondi in 1080p, supporta materiali di riferimento per mantenere la coerenza del soggetto e, per la prima volta, supporta input strutturati di tipo documentale
Prova wan3.0-video-prime
Input
Output
videoPrezzi
wan3.0-video-prime per second
| Specifiche | Prezzo unitario |
|---|---|
| 480P | $0.0875 |
| 720P | $0.180 |
| 1080P | $0.360 |
Panoramica della posizione
wan3.0-video-prime è la linea ad alta qualità della famiglia Wan 3.0 Video orientata al reference-to-video, richiamabile tramite l'interfaccia unificata di HiAPI.ai. Accetta materiali di riferimento come immagini, audio, documenti e pagine web e, combinati con il prompt, genera video con audio fino a 30 secondi e con risoluzione massima 1080P, supportando il controllo del primo e dell'ultimo fotogramma, oltre alla scelta di durata e formato. È adatto a sviluppatori e team di contenuti che necessitano di mantenere la coerenza del soggetto con materiali di brand o di prodotto e di produrre direttamente il video finito.
Punti salienti
- Generazione multimodale guidata dai materiali di riferimento — in una singola chiamata è possibile combinare fino a 10 immagini, 5 tracce audio e riferimenti a documenti o pagine web, citandoli nel prompt nell'ordine dell'array come Image1, Audio1 e così via.
- Durata da 2 a 30 secondi in una sola generazione — il parametro duration determina direttamente la lunghezza dell'output; per narrazioni lunghe non serve concatenare segmenti, basta generare una clip completa in un'unica volta.
- Fino a 1080P con livelli selezionabili — offre tre livelli di risoluzione (480P, 720P, 1080P) e sei formati, consentendo di scegliere di volta in volta in base a qualità e costo.
- Traccia audio sincronizzata e controllo del primo/ultimo fotogramma — l'output include per impostazione predefinita audio sincronizzato, che può anche essere disattivato; le immagini del primo e dell'ultimo fotogramma vincolano i fotogrammi di inizio e fine dell'inquadratura.
Descrizione delle capacità
Generazione con coerenza dei riferimenti: blocca soggetto e stile tramite materiali di riferimento come immagini e audio, mantenendo coerente l'aspetto dello stesso personaggio o prodotto per tutta la durata del video e riducendo le rilavorazioni in post-produzione.
Input strutturato di materiali: supporta il passaggio di un documento o di una pagina web accessibile senza login come riferimento, convertendo, insieme al prompt, il contenuto dei materiali in immagini video di tipo esplicativo.
Durata e formato controllabili: durata da 2 a 30 secondi e sei formati tra cui scegliere; adaptive segue automaticamente i materiali di input e il prompt, facilitando l'adattamento a spazi pubblicitari orizzontali, verticali e così via.
Inquadratura vincolata dal primo e dall'ultimo fotogramma: è possibile specificare separatamente le immagini del primo e dell'ultimo fotogramma, vincolando il punto di partenza e di arrivo dell'inquadratura; ideale per esigenze di video finiti con apertura e chiusura precise.
Riproducibilità e attivazione dell'audio: tramite un seed fisso si riproduce lo stesso risultato; il parametro audio controlla se generare la traccia sincronizzata, facilitando la generazione in batch e il confronto tra versioni.
Scenari di utilizzo
- Da materiali di brand o prodotto a spot pubblicitario — inserendo immagini del prodotto e prompt con i punti di forza, si ottiene uno spot con audio che mantiene coerente l'aspetto del prodotto, per pagine di dettaglio e-commerce e pubblicazioni sui social.
- Segmenti narrativi di personaggi con riferimenti multimodali — con immagini del personaggio e riferimenti audio si generano clip coerenti fino a 30 secondi, da usare come segmenti di trama o di cortometraggi.
- Da materiali a video esplicativo — caricando un documento o un link a una pagina web si generano immagini esplicative sul tema corrispondente, per formazione interna e presentazioni di prodotto.
- Completamento di inquadrature con fotogrammi di inizio e fine specificati — fornendo due immagini chiave, la prima e l'ultima, si genera un'inquadratura di transizione con durata controllabile, da integrare nel flusso di montaggio.
Limiti e consigli sulla scelta
La fatturazione è basata sui secondi di output: maggiore è la risoluzione e la durata, più alto è il costo, quindi combinazioni di video lunghi e alta qualità richiedono una stima preventiva. L'esito della generazione dipende in modo evidente dal prompt: se soggetto, azioni, inquadratura e stile non sono descritti chiaramente, il risultato presenta una notevole variabilità. I materiali di riferimento e la modalità primo/ultimo fotogramma non possono essere combinati: ogni singola generazione accetta un solo documento o una sola pagina web come riferimento. Per clip quotidiane più brevi e leggere si può scegliere la linea standard della stessa famiglia; per attività in batch con parametri fissi e requisiti elevati di riproducibilità si consiglia di fissare il seed prima di aumentare la scala.
Novità
Vedi il changelog →- Nuovo modello Lancio del modello di generazione video wan3.0-video-prime
Domande frequenti
Vedi tutte le domande →-
Che tipo di modello video è Wan 3.0 Video?
Ha il Prompt come elemento centrale e può anche includere frame iniziali e finali oppure immagini, video e audio di riferimento; i diversi metodi di controllo vanno combinati secondo il contratto dei parametri corrente.
-
Quali specifiche di output supporta Wan 3.0 Video?
Supporta da 2 a 30 secondi, con risoluzioni 480P, 720P e 1080P, e formati adaptive, 16:9, 4:3, 1:1, 3:4, 9:16.
-
È possibile generare voce o utilizzare riferimenti audio?
Riferimenti opzionali a immagini, video, audio, file e link; supporto per audio sincronizzato
-
Come viene fatturato Wan 3.0 Video?
La fatturazione si basa sulla durata dell'output e sul livello in tempo reale; le differenze dovute a risoluzione, modalità o opzioni audio sono determinate dai prezzi mostrati sulla pagina e dai registri delle attività.
Crea un'attività di generazione
https://api.hiapi.ai/v1/tasks Header
AuthorizationstringObbligatorioChiave API dell'account. Obbligatoria in ogni richiesta. Esempio: Bearer YOUR_HIAPI_API_KEY. Ottieni una chiave API
Content-TypestringOpzionaleIl corpo della richiesta viene sempre interpretato come JSON; se inviato, è accettato solo application/json (charset facoltativo) — qualsiasi altro valore restituisce 415. Esempio: application/json.
Idempotency-KeystringOpzionaleChiave di idempotenza, fino a 255 byte. I retry con la stessa chiave dello stesso account creano l'attività una sola volta; i replay restituiscono il taskId originale.
In caso di timeout di rete o retry automatici del client, la stessa chiave crea l'attività una sola volta, senza doppi addebiti (ambito = l'account della chiave API). Usa un identificatore univoco di business (es. "order-42"); i replay restituiscono il taskId originale e le chiavi scadono 24 ore dopo la prima richiesta. La matrice completa degli scenari è nell'introduzione dell'API asincrona unificata.
Corpo
modelstringObbligatorioValore fisso attuale: wan3.0-video-prime
routestringOpzionaleValore fisso attuale: default
inputobjectObbligatorio
Oggetto di parametri di business per wan3.0-video-prime e la route default — vedi la tabella dei parametri sotto.
seedintegerOpzionalemin 0max 2147483647Seme casuale; per ottenere un output riproducibile passare un valore fisso, altrimenti viene generato casualmente dal server.
audiobooleanOpzionalePredefinito: trueIndica se includere una traccia audio sincronizzata nel video di output, valore booleano, predefinito true.
promptstringObbligatoriominLength 1maxLength 20000Prompt che descrive scena, movimento, inquadratura, illuminazione e suono; in modalità riferimento fare riferimento ai materiali corrispondenti nell'ordine dell'array come Image1, Audio1, ecc.
durationintegerOpzionalePredefinito: 5min 2max 30Durata del video di output, in secondi, intervallo da 2 a 30, predefinito 5.
resolutionstringOpzionalePredefinito: "1080P"Risoluzione del video di output, predefinita 1080P.
480P720P1080Paspect_ratiostringOpzionalePredefinito: "adaptive"Rapporto d'aspetto dell'immagine di output, predefinito adaptive, ovvero adattivo ai media di input e al prompt.
adaptive16:94:31:13:49:16last_frame_urlstringOpzionaleUn URL di immagine accessibile pubblicamente, da usare come frame finale del video, da utilizzare insieme a first_frame_url.
first_frame_urlstringOpzionaleUn URL di immagine accessibile pubblicamente, da usare come frame iniziale del video; non utilizzabile contemporaneamente all'array di materiali di riferimento.
reference_file_urlsarrayOpzionalemaxItems 1Array di URL di documenti o presentazioni di riferimento, massimo 1, che devono essere accessibili pubblicamente.
Array [ string ]
reference_link_urlsarrayOpzionalemaxItems 1Array di URL di pagine web di riferimento, massimo 1, e la pagina web deve essere accessibile pubblicamente senza login.
Array [ string ]
reference_audio_urlsarrayOpzionalemaxItems 5Array di URL di audio di riferimento, massimo 5 frammenti WAV o MP3, ciascuno da 1 a 15 secondi, da utilizzare insieme a immagini o video.
Array [ string ]
reference_image_urlsarrayOpzionalemaxItems 10Array di URL di immagini di riferimento, massimo 10, per la generazione con riferimento generico.
Array [ string ]
callbackobjectOpzionale
Configurazione di notifica dello stato terminale. Se omessa, nessun callback: interroga l'attività per conto tuo.
Fornisci callback.url in creazione e HiAPI invierà un POST al tuo servizio allo stato terminale, senza polling. Il corpo del callback replica la struttura del dettaglio attività; verifica firma, retry e idempotenza sono descritti nell'introduzione dell'API asincrona unificata.
urlstringObbligatorioObbligatoria se è presente callback. Allo stato terminale viene inviato un POST a questo URL; deve essere un URL http(s) valido.
whenstringOpzionalePredefinito: "final"Al momento è supportato solo final: notifica sia su success sia su fail.
finalstoragestringOpzionalePredefinito: "temp"Livello di archiviazione degli artefatti: temp (predefinito, ~7 giorni) o persistent (a lungo termine, fatturato per dimensione). Saldo insufficiente o superamento del limite ⇒ declassamento silenzioso a temp; il livello effettivo è visibile nella risposta di dettaglio.
temppersistentEsempi di richiesta
# Invia un'attività asincrona; restituisce subito un taskId (senza attendere la generazione)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "wan3.0-video-prime",
"input": {
"audio": true,
"prompt": "…",
"duration": 5,
"resolution": "1080P",
"aspect_ratio": "adaptive"
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "wan3.0-video-prime",
input: {
"audio": true,
"prompt": "…",
"duration": 5,
"resolution": "1080P",
"aspect_ratio": "adaptive"
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "wan3.0-video-prime",
"input": {
"audio": True,
"prompt": "…",
"duration": 5,
"resolution": "1080P",
"aspect_ratio": "adaptive"
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Ottieni i dettagli dell'attività
https://api.hiapi.ai/v1/tasks/:id Campi della risposta
taskIdstringObbligatorioID attività, sempre con prefisso tk-hiapi-.
modelstringObbligatorioNome completo risolto del modello. Le attività inviate con il parametro route restituiscono base@route (es. gpt-image-2/text-to-image@ext); altrimenti coincide con il nome inviato.
routestringOpzionalePresente solo se è stato usato il parametro route esplicito; restituisce il valore inviato.
statusstringObbligatorioStato dell'attività.
queued In coda, non avviata.
handling In elaborazione.
archiving Elaborazione conclusa, preparazione artefatti.
success Terminale: completato, artefatti disponibili (restituisce output).
fail Terminale: errore (restituisce error).
Dopo l'invio, segui status: success e fail sono terminali, il resto no. Esegui polling ogni 1–3 s fino allo stato terminale. In caso di successo scarica gli artefatti da output[].url e trasferiscili prima di expireAt; per conservazione lunga usa storage: "persistent" in creazione.
creatednumberObbligatorioIstante di creazione dell'attività (secondi Unix).
completednumberObbligatorioSecondi Unix dello stato terminale; 0 finché non terminale.
outputarrayOpzionale
Presente solo con status == success. Elenco artefatti — sempre un array; un'attività può restituire più type contemporaneamente (es. video + first_frame).
Array [ object ]
Elementi dell'array
urlstringObbligatorioURL dell'artefatto, scaricabile direttamente.
typestringObbligatorioValori attualmente possibili: video, image, audio, first_frame, last_frame, thumbnail; potrebbero essere ampliati in futuro.
expireAtnumberObbligatorioSecondi Unix di disponibilità dell'artefatto; scarica o trasferisci prima della scadenza.
errorobjectOpzionale
Presente solo con status == fail.
codestringObbligatorioCodice errore di business.
messagestringObbligatorioDescrizione dell'errore.
Esempi di risposta
Successo
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} In elaborazione (non terminale)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Non riuscito
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Articoli
Vedi tutti gli articoli →-
Tutoriale
Come chiamare hailuo-2.3-fast/image-to-video tramite l'API HiAPI: pratica con curl e Python
La prima richiesta funzionante per il livello image-to-video veloce ed economico — dall'ID del modello al download di un MP4
-
Confronto e valutazione
hailuo-2.3-fast/image-to-video confronto orizzontale: come scegliere un modello image-to-video e i punti chiave per la migrazione
-
Tutoriale
Utilizzare Kandinsky 6.0 Pro su HiAPI per la generazione di video da testo: tutorial con curl e Python
Dimostrazione pratica guidata dalla richiesta: costruire la chiamata da prompt a clip video, inviare la richiesta, monitorare lo stato di completamento e scaricare il risultato
-
Tutoriale
Tutorial su kandinsky-6.0-pro/image-to-video tramite HiAPI: curl + Python
Avvia una richiesta funzionante di image-to-video su HiAPI: dal caricamento del primo fotogramma al polling asincrono fino al download finale
-
Tutoriale
Come usare kling-4.0/text-to-video tramite l'API HiAPI: curl, Python e un esempio di richiesta funzionante
Guida pratica per sviluppatori: prompt cinematografici, audio sincronizzato, polling asincrono e download dell'output
-
Tutoriale
Come chiamare hailuo-2.3/text-to-video tramite l'API HiAPI: curl, Python ed esempi di richiesta eseguibili
-
Tutoriale
recraft-v4.1-flash text-to-image in pratica: 5 scenari di business ad alto valore e punti chiave di integrazione
Partendo da un costo di $0,01 per immagine, pianificare l'implementazione della generazione di immagini nei processi di business reali
-
Confronto e valutazione
Confronto orizzontale di Recraft v4.1 Flash per la generazione di immagini da testo: guida alla scelta e alla migrazione per gli sviluppatori
Con un costo di $0,01 per immagine e la capacità di generazione puramente testuale, valuta se è adatto alla tua pipeline di generazione di immagini
-
Tutoriale
Come chiamare kling-4.0/image-to-video su HiAPI: curl, Python e polling
Modelli correlati
Vedi tutti i modelli →Stesso tipo
-
Gemini Omni 1.1 Flash Google $0.450 /video -
Kling AI Avatar Kuaishou -- -
HeyGen Avatar V HeyGen $0.150 /secondo -
FLUX 3 Max Black Forest Labs $0.061 /secondo -
Kling 4.0 Kuaishou $0.330 /secondo -
FLUX 3 Video Black Forest Labs $0.090 /secondo -
Creatify Boreal Creatify $0.015 /secondo -
Wan 2.6 Flash Alibaba $0.043 /secondo -
Grok Imagine 1.5 xAI $0.011 /secondo -
Kling 3.0 Kuaishou $0.100 /secondo -
HappyHorse 1.1 Alibaba $0.160 /secondo -
Gemini Omni Google --
Stesso fornitore
-
Qwen Image 2.0 Alibaba $0.042 /immagine -
Wan 3.0 Video Alibaba $0.040 /secondo -
HappyHorse 1.1 Alibaba $0.160 /secondo -
Wan 2.6 Flash Alibaba $0.043 /secondo -
Z-Image Alibaba $0.008 /immagine -
Wan 2.7 Image Alibaba $0.035 /immagine -
Qwen Image 3.0 Alibaba $0.036 /immagine -
HappyHorse 1.0 Alibaba $0.168 /secondo -
Qwen Audio 3.0 TTS Alibaba $0.030 /1.000 caratteri -
Qwen Image 2.1 Alibaba $0.020 /immagine -
Wan 2.7 Video Alibaba $0.100 /secondo