Veo 3.1 Lite
veo-3.1-lite/text-to-video
Livello di generazione video di Google a basso costo e ad alto throughput, con una velocità pari a Veo 3.1 Fast, supporta la generazione di video da immagini, diversi formati e durate
Prova veo-3.1-lite/text-to-video
Input
Creazioni
Vedi tutte le creazioniOutput
videoPrezzi
veo-3.1-lite/text-to-video per second
Panoramica e posizionamento
veo-3.1-lite/text-to-video è la linea text-to-video della famiglia Google Veo 3.1 Lite, pensata per gli sviluppatori che necessitano di produrre video brevi in grandi quantità. Basta inserire un prompt in linguaggio naturale per generare clip video con audio nativo, con supporto per 720p/1080p, formati 16:9 e 9:16, durate di 4/6/8 secondi e controllo dei risultati tramite parametri come seed e negative_prompt. È adatta a scenari ingegneristici sensibili ai costi e alla velocità di iterazione, come spot marketing brevi, contenuti per i social media e generazione video all'interno di prodotti, richiamabile tramite l'interfaccia unificata di HiAPI.ai.
Punti di forza principali
- Generazione audio nativa — l'audio viene prodotto contemporaneamente alle immagini ed è attivo per impostazione predefinita; può essere disattivato per adattarsi a flussi di montaggio senza audio.
- Copertura sia orizzontale che verticale — sono integrati i rapporti 16:9 e 9:16: una sola integrazione basta a soddisfare la distribuzione di contenuti sia in orizzontale che in verticale.
- Durata e risoluzione selezionabili — tre durate (4, 6 e 8 secondi) abbinate a risoluzioni 720p/1080p consentono di bilanciare qualità del video finale e costi in base allo scenario.
- Parametri di controllo completi — offre opzioni come seed per la riproducibilità, negative_prompt per escludere contenuti, auto_fix per correggere il prompt e tolleranza di sicurezza.
Descrizione delle capacità
Generazione video da prompt: descrive una scena in linguaggio naturale e genera la clip video corrispondente; è il metodo di input fondamentale per costruire pipeline video automatizzate.
Output audio nativo: il risultato generato include audio sincronizzato, eliminando la necessità di doppiaggio ed effetti sonori successivi; disattivandolo si ottiene materiale muto.
Output multiprofilo: combinando i tre parametri resolution, aspect_ratio e duration si ottiene la specifica desiderata, e l'output può entrare direttamente nel flusso di montaggio o pubblicazione.
Risultati controllabili e riproducibili: un seed fisso consente di riprodurre lo stesso risultato, negative_prompt evita elementi indesiderati e auto_fix riscrive automaticamente il prompt in caso di validazione fallita, riducendo il tasso di chiamate fallite.
Scenari di utilizzo
- Produzione in serie di spot pubblicitari da parte dei team marketing — inserendo il tema della campagna e la descrizione dei punti di forza, si generano in serie clip da 8 secondi con audio per test di materiali pubblicitari e iterazioni A/B rapide.
- Video verticali per produttori di contenuti social — generazione di clip brevi in formato 9:16, utilizzabili direttamente per aggiornare i contenuti su piattaforme di video brevi e feed social.
- Integrazione di capacità video per sviluppatori di prodotto — richiamare automaticamente la generazione video tramite prompt all'interno del prodotto, offrendola agli utenti finali come modulo funzionale.
- Previsualizzazione di script per team creativi — convertire rapidamente lo storyboard testuale in clip da 4 secondi e, con seed fissi, riprodurre la soluzione per la conferma visiva in fase di proposta.
Limiti e consigli di selezione
La durata massima per singola generazione è di 8 secondi e la risoluzione massima è 1080p: non è adatta a video lunghi, narrazioni continue o esigenze di maggiore definizione; per progetti complessi che richiedono movimenti di camera precisi e raccordi tra inquadrature, si consiglia di suddividere in più segmenti generati e montarli successivamente. Il parametro di tolleranza di sicurezza limita la produzione di contenuti su alcuni temi. Se l'attività parte da un'immagine, è necessario scegliere la linea image-to-video della stessa famiglia anziché questa.
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-lite/text-to-video
routestringOpzionaleValore fisso attuale: default
inputobjectObbligatorio
Oggetto di parametri di business per veo-3.1-lite/text-to-video e la route default — vedi la tabella dei parametri sotto.
seedintegerOpzionaleSeme casuale utilizzato per generare risultati riproducibili; passando lo stesso seme e gli stessi parametri si ottiene un output video identico. Se non specificato, viene deciso casualmente dal server.
promptstringObbligatoriominLength 1Prompt testuale che descrive il contenuto del video da generare, input principale per la generazione video da testo.
auto_fixbooleanOpzionalePredefinito: trueIndica se riscrivere automaticamente i prompt che non superano la validazione. Predefinito true.
durationintegerOpzionalePredefinito: 8min 4max 8Durata del segmento video generato, in secondi. Predefinito 8 secondi.
468resolutionstringOpzionalePredefinito: "720p"Risoluzione del video di output. Predefinito 720p.
720p1080paspect_ratiostringOpzionalePredefinito: "16:9"Proporzioni (larghezza/altezza) del video di output. Predefinito 16:9.
16:99:16generate_audiobooleanOpzionalePredefinito: trueIndica se generare l'audio nativo locale. Predefinito true.
negative_promptstringOpzionalePrompt negativo che specifica i contenuti da evitare nel video generato.
safety_tolerancestringOpzionalePredefinito: "4"Livello di tolleranza della moderazione dei contenuti. Predefinito "4".
123456callbackobjectOpzionale
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-lite/text-to-video",
"input": {
"prompt": "…",
"auto_fix": true,
"duration": 8,
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": true,
"safety_tolerance": "4"
}
}' 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-lite/text-to-video",
input: {
"prompt": "…",
"auto_fix": true,
"duration": 8,
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": true,
"safety_tolerance": "4"
}
}),
});
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-lite/text-to-video",
"input": {
"prompt": "…",
"auto_fix": True,
"duration": 8,
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": True,
"safety_tolerance": "4"
}
},
)
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 kling-4.0/image-to-video su HiAPI: curl, Python e polling
-
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
-
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
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
Modelli correlati
Vedi tutti i modelli →Stesso tipo
-
Kandinsky 6.0 Pro $1.93 /video -
HeyGen Avatar IV HeyGen $0.150 /secondo -
PixVerse V6 PixVerse $0.036 /secondo -
Wan 2.6 Flash Alibaba $0.043 /secondo -
LTX 2.5 Fast Lightricks $0.086 /secondo -
Gemini Omni Google -- -
Grok Imagine 1.5 xAI $0.011 /secondo -
Gemini Omni 1.1 Flash Google $0.450 /video -
MiniMax H3 MiniMax $0.072 /secondo -
Vidu Q4 Preview Vidu $0.051 /secondo -
HeyGen Avatar V HeyGen $0.150 /secondo -
Grok Imagine 1.5 Lite xAI $0.029 /secondo
Stesso fornitore
-
Veo 3.1 Google $0.290 /secondo -
Nano Banana Google $0.021 /immagine -
Gemini Omni 1.1 Flash Google $0.450 /video -
Veo 3.1 Fast Google $0.170 /secondo -
Imagen 4 Google $0.030 /immagine -
Google Virtual Try-On Google $0.107 /immagine -
Nano Banana 2 Lite Google $0.033 /immagine -
Nano Banana Pro Google $0.057 /immagine -
Nano Banana 2 Google $0.036 /immagine -
Gemini Omni Google -- -
Lyria 3.5 Google $0.090 /brano -
Veo 3.1 Lite Google $0.060 /secondo