Veo 3.1 Lite
veo-3.1-lite/image-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/image-to-video
Input
Creazioni
Vedi tutte le creazioniOutput
videoPrezzi
veo-3.1-lite/image-to-video per second
Panoramica e posizionamento
veo-3.1-lite/image-to-video è il modello di generazione video da immagine della famiglia Google Veo 3.1 Lite, richiamabile tramite l'interfaccia unificata di HiAPI.ai. Prende avvio da un'immagine di input e, combinando il prompt, trasforma una scena statica in una clip video con audio nativo; l'output supporta 720p e 1080p, formati 16:9 e 9:16, con durata selezionabile di 4, 6 o 8 secondi. È adatto a sviluppatori che devono convertire in batch materiali grafici esistenti in brevi video e a team che integrano capacità di generazione video in prodotti sensibili ai costi.
Punti di forza principali
- Ancorato all'immagine, punto di partenza controllabile — usa l'immagine di input come condizione di generazione e, insieme al prompt che descrive il movimento, riduce la deriva visiva tipica della generazione da solo testo.
- Audio nativo generato insieme al video — l'audio nativo è generato per impostazione predefinita, permettendo di ottenere direttamente clip con sonoro, senza passaggi separati di doppiaggio o sintesi di effetti.
- Formato e durata combinabili a piacere — supporta i formati 16:9 e 9:16, le risoluzioni 720p e 1080p e durate di 4, 6 o 8 secondi.
- Processo di generazione regolabile e controllabile — offre prompt negativi, seed casuale e parametri di tolleranza di sicurezza, utili per riprodurre i risultati e vincolare i contenuti generati.
Descrizione delle capacità
Generazione video guidata da immagine: passando l'URL dell'immagine e un prompt che descrive il movimento si genera il video corrispondente; si consiglia un'immagine di input da 720p o superiore, in formato 16:9 o 9:16.
Scelta di risoluzione e formato: l'output può essere 720p o 1080p, con formato 16:9, 9:16 o dedotto automaticamente dall'immagine, coprendo sia contenuti orizzontali sia short video verticali.
Durata controllabile: la durata di una singola generazione può essere impostata a 4, 6 o 8 secondi, con 8 secondi come predefinito; la fatturazione avviene sui secondi prodotti, facilitando il controllo dei costi in base alla lunghezza della clip.
Attivazione dell'audio: è possibile attivare o disattivare la generazione dell'audio nativo; quando serve materiale muto per un doppiaggio successivo, si può disattivare per ridurre elaborazioni inutili.
Vincoli di output e riproducibilità: tramite prompt negativi si escludono contenuti indesiderati, con la tolleranza di sicurezza si regola l'intensità della moderazione e con un seed fisso si riproduce lo stesso risultato.
Scenari d'uso
- Team e-commerce e pubblicitari: da immagine statica di prodotto a clip dinamica — trasformare le immagini di prodotto in brevi clip dinamiche di alcuni secondi per pagine di dettaglio, annunci in-feed e materiali per i social media.
- Gestione contenuti: produzione in batch di short video verticali — con formato 9:16 e durata da 4 a 8 secondi, convertire materiali grafici in short video per l'aggiornamento quotidiano dei contenuti sulle piattaforme di short video.
- Team di prodotto: integrazione della funzione immagine-video — integrare nei prodotti la capacità di generazione video da immagine, così che gli utenti, caricando un'immagine, ottengano una breve clip con audio.
- Validazione creativa: anteprima rapida di storyboard e bozzetti — convertire rapidamente storyboard o concept in anteprime dinamiche per la revisione dei progetti e la conferma della direzione creativa, prima di decidere se investire nella produzione successiva.
Limiti e consigli di scelta
La risoluzione massima è 1080p e la durata massima per singola generazione è di 8 secondi, quindi non è adatto a video lunghi o a prodotti finali a risoluzione superiore; l'input richiede un'immagine da almeno 720p, mentre per partire da solo testo occorre usare la linea text-to-video della stessa famiglia. I risultati dipendono dal prompt e dai parametri di moderazione, per cui vanno previsti costi di ritentativi e selezione. Se servono durate più lunghe, risoluzioni più alte o un controllo più forte della coerenza visiva, è opportuno valutare modelli video di fascia superiore.
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/image-to-video
routestringOpzionaleValore fisso attuale: default
inputobjectObbligatorio
Oggetto di parametri di business per veo-3.1-lite/image-to-video e la route default — vedi la tabella dei parametri sotto.
seedintegerOpzionaleSeme casuale, valore intero, utilizzato per rendere riproducibile il risultato della generazione; con lo stesso seme e gli altri parametri identici si ottiene lo stesso output.
promptstringObbligatoriominLength 1Prompt testuale che descrive come si desidera animare l'immagine di input, valore stringa.
auto_fixbooleanOpzionalePredefinito: falseSe riscrivere automaticamente i prompt che non superano la validazione, valore booleano, predefinito false.
durationintegerOpzionalePredefinito: 8min 4max 8Durata del frammento video generato, in secondi, valore intero, predefinito 8.
468image_urlstringObbligatorioURL dell'immagine di input da animare, stringa; si consiglia un'immagine con proporzioni 16:9 o 9:16 e risoluzione non inferiore a 720p.
resolutionstringOpzionalePredefinito: "720p"Risoluzione del video di output, stringa, predefinita 720p.
720p1080paspect_ratiostringOpzionalePredefinito: "auto"Proporzioni del video di output, stringa, predefinite auto.
auto16:99:16generate_audiobooleanOpzionalePredefinito: trueSe generare audio nativo, valore booleano, predefinito true.
negative_promptstringOpzionalePrompt negativo che descrive i contenuti da evitare nel video generato, valore stringa.
safety_tolerancestringOpzionalePredefinito: "4"Livello di tolleranza della moderazione dei contenuti, stringa, 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/image-to-video",
"input": {
"prompt": "…",
"auto_fix": false,
"duration": 8,
"image_url": "…",
"resolution": "720p",
"aspect_ratio": "auto",
"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/image-to-video",
input: {
"prompt": "…",
"auto_fix": false,
"duration": 8,
"image_url": "…",
"resolution": "720p",
"aspect_ratio": "auto",
"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/image-to-video",
"input": {
"prompt": "…",
"auto_fix": False,
"duration": 8,
"image_url": "…",
"resolution": "720p",
"aspect_ratio": "auto",
"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
-
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
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 chiamare hailuo-2.3/text-to-video tramite l'API HiAPI: curl, Python ed esempi di richiesta eseguibili
-
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
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
Modelli correlati
Vedi tutti i modelli →Stesso tipo
-
Ray 3.2 Luma $0.214 /video -
Kandinsky 6.0 Pro $1.93 /video -
HeyGen Avatar V HeyGen $0.150 /secondo -
Kling 4.0 Kuaishou $0.330 /secondo -
LTX 2.5 Fast Lightricks $0.086 /secondo -
Kling 3.0 Kuaishou $0.100 /secondo -
FLUX 3 Max Black Forest Labs $0.061 /secondo -
HappyHorse 1.1 Alibaba $0.160 /secondo -
Grok Imagine 1.5 Lite xAI $0.029 /secondo -
Runway Gen 4.5 Runway $0.172 /secondo -
Wan 3.0 Video Alibaba $0.040 /secondo -
Vidu Q3 Vidu $0.149 /secondo
Stesso fornitore
-
Gemini Omni Google -- -
Google Virtual Try-On Google $0.107 /immagine -
Lyria 3.5 Google $0.090 /brano -
Nano Banana 2 Lite Google $0.033 /immagine -
Veo 3.1 Google $0.290 /secondo -
Gemini 3.1 Flash TTS Google -- -
Nano Banana 2 Google $0.036 /immagine -
Nano Banana Google $0.021 /immagine -
Lyria 3 Pro Google $0.140 /brano -
Nano Banana Pro Google $0.057 /immagine -
Veo 3.1 Fast Google $0.170 /secondo -
Imagen 4 Google $0.030 /immagine


