Vidu
Vidu Q4 Preview
vidu-q4-preview/reference-to-video
La prima anteprima pubblica della serie Vidu Q4, incentrata sulla recitazione dei personaggi e sull'audio nativo, supporta fino a 15 immagini e 3 riferimenti audio come guida, con output video fino a 4K
Prova vidu-q4-preview/reference-to-video
Input
Creazioni
Vedi tutte le creazioniOutput
videoPrezzi
vidu-q4-preview/reference-to-video per second
| Specifiche | Prezzo unitario |
|---|---|
| 540P | $0.0515 |
| 720P | $0.109 |
| 1080P | $0.1375 |
| 2K | $0.2175 |
| 4K | $0.446 |
Panoramica della posizione
La linea di generazione video con riferimenti di Vidu Q4 Preview è pensata per gli sviluppatori che necessitano di mantenere coerenti personaggi, scene e audio nel video finale. Caricando da 1 a 15 immagini di riferimento (persone, scene o oggetti) e fino a 3 riferimenti audio, insieme a un prompt testuale, è possibile generare video da 3 a 16 secondi, con risoluzione selezionabile da 540p a 4K e audio nativo sincronizzato con le immagini emesso per impostazione predefinita. È adatta alla creazione di contenuti brevi seriali, a clip di dialogo tra personaggi e alla previsualizzazione di inquadrature che richiedono il confronto tra più proposte.
Punti salienti
- Coerenza di personaggi e scene tramite più immagini di riferimento — è possibile usare fino a 15 immagini di riferimento per vincolare persone, scene e oggetti, citandole in ordine nel prompt, riducendo la deriva dell'aspetto tra inquadrature diverse.
- Generazione di doppiaggio guidata da riferimenti audio — è possibile aggiungere fino a 3 campioni vocali MP3 da 3 a 12 secondi come riferimento di timbro, rendendo i dialoghi generati più vicini alla voce indicata.
- Audio nativo emesso per impostazione predefinita — per impostazione predefinita vengono generati dialoghi ed effetti sonori sincronizzati con il video; è anche possibile disattivarli per ottenere materiale muto, evitando la post-elaborazione di separazione delle tracce audio.
- Durata, formato e risoluzione regolabili — durata da 3 a 16 secondi, cinque formati di aspect ratio e cinque livelli di risoluzione da 540p a 4K: la stessa linea copre esigenze orizzontali, verticali e di diverse nitidezze.
Descrizione delle capacità
Generazione vincolata da immagini di riferimento: inserendo da 1 a 15 immagini JPG, PNG o WEBP e citandole in ordine nel prompt, si bloccano l'aspetto dei personaggi, le scene e gli oggetti chiave, ideale per più video che devono mantenere lo stesso aspetto.
Doppiaggio con riferimento di timbro: allegando fino a 3 riferimenti vocali MP3 da 3 a 12 secondi e specificando nel prompt l'interlocutore, i dialoghi dei personaggi assumono le caratteristiche del timbro desiderato.
Interruttore audio sincronizzato: il parametro audio è attivo per impostazione predefinita e genera video con dialoghi ed effetti sonori; disattivandolo si ottiene un video solo immagini, utile per doppiaggio e colonna sonora in post-produzione.
Specifiche di output personalizzabili: supporta cinque formati (16:9, 9:16, 1:1, 4:3, 3:4) e risoluzioni da 540p a 4K, producendo direttamente video adatti a diversi canali di distribuzione.
Descrizioni con prompt lunghi: il prompt può raggiungere i 20000 caratteri, sufficienti per descrizioni strutturate con ruoli di più personaggi, movimenti di macchina e battute di dialogo.
Scenari d'uso
- Creatori di contenuti brevi seriali — generare in blocco più clip con lo stesso set di immagini di riferimento di personaggi e scene, mantenendo l'aspetto coerente, per aggiornamenti sui social o episodi di serie.
- Produzione di scene narrative con battute — fornire immagini di riferimento dei personaggi e campioni vocali, specificando le battute, per ottenere clip con dialoghi sincronizzati da usare come previsualizzazione dello storyboard o come materiale finale.
- Confronto di più proposte per spot pubblicitari e video di marca — cambiando immagini di riferimento e prompt si provano rapidamente versioni con inquadrature e aperture diverse, per orientare il team prima delle riprese ufficiali.
- Adattamento dei materiali per la distribuzione multipiattaforma — generare una versione per ogni formato e risoluzione, coprendo le esigenze di materiali orizzontali, verticali e in alta definizione.
Limiti e suggerimenti per la scelta
La durata massima di una singola generazione è di 16 secondi; narrazioni più lunghe richiedono generazione a segmenti e successivo montaggio. I materiali di riferimento sono limitati a un massimo di 15 immagini e 3 audio, con riferimento audio solo in formato MP3 e ogni segmento da 3 a 12 secondi. Essendo una versione preview, capacità e parametri potrebbero cambiare in futuro; non è quindi adatta a processi di produzione di massa che richiedono altissima stabilità dell'output. Se serve solo guidare le immagini da un singolo primo fotogramma, si può scegliere la linea di generazione da primo fotogramma della stessa serie; per inquadrature continue più lunghe, occorre valutare i costi di post-produzione per il montaggio a segmenti.
Domande frequenti
Vedi tutte le domande →-
È possibile impostare autonomamente le proporzioni nella generazione video da immagine?
No. Le proporzioni del video finale seguono completamente l'immagine del primo fotogramma: caricando un'immagine orizzontale si ottiene un video orizzontale, caricando un'immagine verticale si ottiene un video verticale, quindi per ottenere un formato verticale 9:16 è necessario preparare un primo fotogramma in versione verticale. Il rapporto larghezza-altezza del primo fotogramma deve essere compreso tra 1:4 e 4:1; le immagini eccessivamente allungate verranno rifiutate al momento dell'invio.
-
A cosa serve l'interruttore audio?
L'audio nativo è attivo per impostazione predefinita e genera dialoghi, suoni ambientali ed effetti sonori sincronizzati con le immagini; se disattivato, viene prodotto un video senza audio, adatto come sfondo in loop, per aggiungere musica in post-produzione o per inserire sottotitoli. L'interruttore non influisce sul prezzo.
-
Qual è il rapporto tra durata e prezzo?
La fatturazione si basa sulla durata in secondi interi inviata moltiplicata per il prezzo al secondo della risoluzione scelta; l'attivazione dell'audio e il numero di immagini non incidono sul calcolo. Più alta è la risoluzione, più alto è il prezzo al secondo: la fascia 4K costa circa 8,7 volte la fascia 540p. Gli importi esatti sono quelli indicati nella pagina dei prezzi.
-
A quali scenari si adatta ciascuno dei cinque livelli di risoluzione?
540p serve per provare i prompt e le inquadrature, ed è sufficiente anche per sfondi in loop di piccole dimensioni; 720p copre la maggior parte dei social media e del web; 1080p si usa per la distribuzione standard; 2K è adatto a schermi grandi e alla visualizzazione su TV; 4K si usa per allestimenti espositivi, immagini di livello cinematografico o inquadrature che richiedono ritaglio in post-produzione per una seconda composizione. Prima della versione definitiva, prova con i livelli bassi; per la versione definitiva, esporta con i livelli alti.
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: vidu-q4-preview/reference-to-video
routestringOpzionaleValore fisso attuale: default
inputobjectObbligatorio
Oggetto di parametri di business per vidu-q4-preview/reference-to-video e la route default — vedi la tabella dei parametri sotto.
audiobooleanOpzionalePredefinito: trueIndica se generare audio nativo sincronizzato con il video (dialoghi ed effetti sonori); valore booleano, predefinito true, se impostato su false restituisce un video senza audio.
promptstringObbligatoriominLength 1maxLength 20000Prompt del contenuto del video, è possibile fare riferimento ai materiali di riferimento tramite numero (ad esempio «l'uomo nell'immagine di riferimento 2 parla con l'audio di riferimento 1»); stringa, lunghezza massima 20000 caratteri.
durationintegerOpzionalePredefinito: 5min 3max 16Durata del video (secondi); numero intero compreso tra 3 e 16, predefinito 5.
resolutionstringOpzionalePredefinito: "720p"Risoluzione del video di output; stringa, predefinita 720p.
540p720p1080p2k4kaspect_ratiostringOpzionalePredefinito: "16:9"Proporzioni del video di output; stringa, predefinite 16:9.
16:99:161:14:33:4reference_audio_urlsarrayOpzionalemaxItems 3Array opzionale di URL di audio di riferimento, massimo 3 clip, utilizzate come riferimento timbrico; ogni clip supporta solo MP3, non supera 50MB e ha una durata di 3-12 secondi.
Array [ string ]
reference_image_urlsarrayObbligatoriominItems 1maxItems 15Array di URL di immagini di riferimento, contenente da 1 a 15 immagini per mantenere la coerenza di personaggi, scene e oggetti; ogni immagine supporta JPG, JPEG, PNG o WEBP, non supera 50MB, almeno 128×128 pixel, con proporzioni comprese tra 1:4 e 4:1.
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": "vidu-q4-preview/reference-to-video",
"input": {
"audio": true,
"prompt": "…",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"reference_image_urls": "…"
}
}' 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: "vidu-q4-preview/reference-to-video",
input: {
"audio": true,
"prompt": "…",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"reference_image_urls": "…"
}
}),
});
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": "vidu-q4-preview/reference-to-video",
"input": {
"audio": True,
"prompt": "…",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"reference_image_urls": "…"
}
},
)
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 →-
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
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
-
Tutoriale
Come chiamare hailuo-2.3/text-to-video tramite l'API HiAPI: curl, Python ed esempi di richiesta eseguibili
-
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
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
-
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 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 kling-4.0/image-to-video su HiAPI: curl, Python e polling
-
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
Modelli correlati
Vedi tutti i modelli →Stesso tipo
-
HappyHorse 1.1 Alibaba $0.160 /secondo -
Veo 3.1 Fast Google $0.170 /secondo -
Kling AI Avatar Kuaishou -- -
Vidu Q3 Vidu $0.149 /secondo -
Runway Gen 4.5 Runway $0.172 /secondo -
Seedance 2.5 ByteDance $0.121 /secondo -
HeyGen Avatar IV HeyGen $0.150 /secondo -
Grok Imagine 1.5 xAI $0.011 /secondo -
FLUX 3 Video Black Forest Labs $0.090 /secondo -
HeyGen Avatar V HeyGen $0.150 /secondo -
Kling 3.0 Turbo Kuaishou $0.130 /secondo -
Kandinsky 6.0 Pro $1.93 /video





