Veo 3.1
veo-3.1/text-to-video
Modello di generazione video di Google: l'input immagine permette di generare nativamente video di 8 secondi con audio ambientale e dialoghi, con supporto fino al 4K e mantenimento dell'aspetto coerente del soggetto
Prova veo-3.1/text-to-video
Input
Creazioni
Vedi tutte le creazioniOutput
videoPrezzi
veo-3.1/text-to-video per second
Panoramica e posizionamento
La linea di generazione video da testo di Veo 3.1 è pensata per gli sviluppatori che necessitano di produrre direttamente un filmato a partire da una singola frase testuale. Genera su richiesta video orizzontali o verticali da 4 a 8 secondi, da 720p a 4K, con traccia audio nativa opzionale, così che suoni ambientali, dialoghi ed effetti sonori descritti nel prompt vengano generati in sincrono con le immagini. Basta passare il prompt tramite l'interfaccia unificata di HiAPI.ai per richiamarlo; è adatto a spot pubblicitari brevi, contenuti verticali per i social media e previsualizzazioni di storyboard, ovvero tutti gli scenari in cui occorre validare rapidamente un'idea visiva.
Punti di forza principali
- Sincronizzazione nativa audio-video, senza doppiaggio separato — attivando la generazione audio, il video include suoni ambientali, dialoghi ed effetti sonori, riducendo le fasi di sound design e compositing in post-produzione.
- Output fino a 4K in una singola esecuzione — il parametro resolution offre 720p, 1080p e 4k, soddisfacendo esigenze diverse, dall'anteprima rapida alla consegna in alta qualità.
- Passaggio immediato tra formato orizzontale e verticale — aspect_ratio supporta 16:9 e 9:16, così lo stesso prompt può produrre direttamente versioni adatte a feed o piattaforme verticali.
- Controllo dell'output tramite seed e prompt negativo — il parametro seed permette di riprodurre i risultati, mentre negative_prompt esclude elementi indesiderati, utile per mantenere uno stile fisso nella produzione in serie.
Descrizione delle capacità
Video brevi direttamente da testo: inserendo un prompt descrittivo (fino a 20000 caratteri) si ottiene direttamente una clip video di 4, 6 o 8 secondi, senza bisogno di alcun materiale.
Generazione di traccia audio nativa: è possibile generare audio nativo descrivendo nel prompt suoni ambientali, dialoghi o effetti sonori; il filmato risultante avrà l'audio sincronizzato, eliminando il processo di doppiaggio separato.
Controllo di risoluzione e formato: la risoluzione di output copre 720p, 1080p e 4k, mentre il formato supporta 16:9 e 9:16, da scegliere in base al canale di distribuzione.
Riproducibilità e vincoli negativi: impostando un seed fisso si può rigenerare lo stesso risultato, mentre negative_prompt serve a escludere elementi visivi indesiderati, utile per mantenere la coerenza nella produzione in serie.
Scenari d'uso
- Produzione rapida di spot pubblicitari da parte dei team marketing — con un prompt sui punti di forza del prodotto si genera una clip di 8 secondi con audio, da usare direttamente per la validazione rapida dei materiali e il montaggio iniziale.
- Creazione di video verticali brevi per i social media — si generano video brevi in formato 9:16 da pubblicare su feed o piattaforme di short video, evitando il ritaglio da orizzontale.
- Previsualizzazione di storyboard in pre-produzione audiovisiva — la descrizione dello storyboard viene convertita in clip dinamiche con effetti sonori, utili per la visualizzazione del concept e la comunicazione nel team, riducendo i costi di prova prima delle riprese dal vivo.
- Pipeline di produzione di contenuti programmatica — gli sviluppatori inviano i prompt in batch tramite l'interfaccia unificata e integrano le clip generate nel proprio sistema di gestione dei contenuti o nei flussi di lavoro automatizzati.
Limiti e suggerimenti per la scelta
La durata massima per singola generazione è di 8 secondi; per contenuti più lunghi occorre generare più volte e poi concatenare. Attivare l'audio o aumentare la risoluzione incrementa il costo per singola chiamata, quindi si consiglia di scegliere le specifiche in base ai requisiti di distribuzione. Questa linea è di generazione video da testo e non consente di caricare immagini di riferimento per mantenere coerente l'aspetto di persone o prodotti; per questa esigenza occorre passare alla linea di generazione video da immagine della stessa famiglia. Se servono coerenza multi-inquadratura e narrazioni lunghe, rimangono necessari un'organizzazione manuale aggiuntiva e una gestione della coerenza.
Domande frequenti
Vedi tutte le domande →-
Che tipo di modello video è Veo 3.1 Text to Video?
È una linea di generazione video puramente text-to-video: richiede solo un Prompt testuale e non necessita del caricamento di un'immagine iniziale.
-
Quali specifiche di output supporta Veo 3.1 Text to Video?
Supporta video da 4 a 8 secondi, con risoluzioni che includono 720p, 1080p e 4k, e formati d'immagine che includono 16:9 e 9:16.
-
È possibile generare una voce o utilizzare un riferimento audio?
La generazione audio è abilitata per impostazione predefinita
-
Come viene fatturato Veo 3.1 Text to Video?
La fatturazione si basa sulla durata dell'output e sul livello in tempo reale; eventuali differenze dovute a risoluzione, modalità o opzioni audio sono determinate dai prezzi indicati nella pagina e dai record 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: veo-3.1/text-to-video
routestringOpzionaleValore fisso attuale: default
inputobjectObbligatorio
Oggetto di parametri di business per veo-3.1/text-to-video e la route default — vedi la tabella dei parametri sotto.
seedintegerOpzionaleSeme casuale per risultati di generazione riproducibili; assume valori interi. Lo stesso seme con lo stesso input riproduce lo stesso output; se non specificato, viene generato casualmente dal sistema.
promptstringObbligatoriominLength 1maxLength 20000Prompt testuale che descrive il contenuto video desiderato; assume valori stringa.
durationintegerObbligatorioPredefinito: 8min 4max 8Durata del frammento video in secondi; il costo aumenta con la durata. Predefinito 8 secondi.
468resolutionstringObbligatorioPredefinito: "720p"Risoluzione del video di output; più alta è la risoluzione, più alto è il costo. Predefinito 720p.
720p1080p4kaspect_ratiostringOpzionalePredefinito: "16:9"Proporzioni del video di output. Predefinito 16:9.
16:99:16generate_audiobooleanOpzionalePredefinito: trueIndica se generare una traccia audio nativa per il video; se attivo, il prezzo è più alto. Predefinito true.
negative_promptstringOpzionalePrompt negativo che descrive i contenuti da evitare nel video generato; assume valori stringa.
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": "veo-3.1/text-to-video",
"input": {
"prompt": "…",
"duration": 8,
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": true
}
}' 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: "veo-3.1/text-to-video",
input: {
"prompt": "…",
"duration": 8,
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": true
}
}),
});
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": "veo-3.1/text-to-video",
"input": {
"prompt": "…",
"duration": 8,
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": True
}
},
)
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
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
-
Tutoriale
Come chiamare hailuo-2.3/text-to-video tramite l'API HiAPI: curl, Python ed esempi di richiesta eseguibili
-
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
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
-
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
-
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
Modelli correlati
Vedi tutti i modelli →Stesso tipo
-
Seedance 2.0 ByteDance $0.017 /secondo -
FLUX 3 Max Black Forest Labs $0.061 /secondo -
PixVerse V6 PixVerse $0.036 /secondo -
Veo 3.1 Google $0.290 /secondo -
Seedance 2.5 ByteDance $0.121 /secondo -
Gemini Omni 1.1 Flash Google $0.450 /video -
Wan 2.7 Video Alibaba $0.100 /secondo -
Wan 2.6 Flash Alibaba $0.043 /secondo -
Kling 2.5 Kuaishou $0.060 /secondo -
Kandinsky 6.0 Pro $1.93 /video -
Grok Imagine 1.5 xAI $0.011 /secondo -
Kling 3.0 Turbo Kuaishou $0.130 /secondo
Stesso fornitore
-
Lyria 3 Pro Google $0.140 /brano -
Veo 3.1 Fast Google $0.170 /secondo -
Nano Banana Pro Google $0.057 /immagine -
Gemini Omni 1.1 Flash Google $0.450 /video -
Nano Banana Google $0.021 /immagine -
Imagen 4 Google $0.030 /immagine -
Nano Banana 2 Google $0.036 /immagine -
Gemini 3.1 Flash TTS Google -- -
Veo 3.1 Lite Google $0.060 /secondo -
Google Virtual Try-On Google $0.107 /immagine -
Lyria 3.5 Google $0.090 /brano -
Nano Banana 2 Lite Google $0.033 /immagine