Gemini Omni 1.2
gemini-omni-1.2-flash
Modello di generazione video di Google, supporta la generazione di video da testo, da immagine e da immagini di riferimento, con la possibilità di caricare fino a 10 immagini di riferimento, e consente inoltre di specificare il punto di partenza e di arrivo della scena tramite il primo fotogramma o il primo e l'ultimo fotogramma; ideale per la creazione di video di presentazione di prodotti e materiali pubblicitari per i social media
Prova gemini-omni-1.2-flash
Input
Creazioni
Vedi tutte le creazioniOutput
videoPrezzi
gemini-omni-1.2-flash per second
| Specifiche | Prezzo unitario |
|---|---|
| 360P | $0.0229 |
| 720P | $0.0343 |
| 1080P | $0.0343 |
| 4K | $0.080 |
Panoramica della posizione
Questo è un modello di generazione video pensato per gli sviluppatori, in grado di produrre brevi clip video a partire da descrizioni testuali, immagini di riferimento o fotogrammi iniziale e finale, con una durata per singola generazione da 3 a 15 secondi, fino a un massimo di 10 secondi quando si utilizza la modalità primo/ultimo fotogramma. È possibile usare un'immagine pubblica come contenuto o stile di riferimento, oppure specificare il fotogramma di apertura tramite il primo fotogramma; l'input con immagine di riferimento e quello con fotogrammi sono mutuamente esclusivi. È adatto a team di e-commerce, advertising e creativi che necessitano di produrre in serie materiali video brevi in formato orizzontale o verticale.
Punti di forza principali
- Due modalità di controllo: immagine di riferimento e primo/ultimo fotogramma — fino a 10 immagini pubbliche possono essere usate come riferimento per personaggi, prodotti o stile; è anche possibile specificare i fotogrammi di inizio e fine tramite primo e ultimo fotogramma.
- Scelta di formato e risoluzione in base al canale di distribuzione — il formato supporta 16:9 orizzontale o 9:16 verticale, mentre la risoluzione può essere scelta tra 360p, 720p, 1080p e 4k.
- Il prompt può descrivere scene e movimenti di camera — il prompt è obbligatorio e può contenere fino a 20000 caratteri, specificando il contenuto dell'immagine, il movimento e le modalità di avanzamento della camera.
Descrizione delle capacità
Text-to-video e reference-image-to-video: è sufficiente fornire il prompt per generare un video; image_urls accetta da 1 a 10 immagini pubbliche HTTP(S), e anche con una sola immagine questa viene trattata come immagine di riferimento, utile a vincolare personaggi, prodotti o stile.
Primo fotogramma e transizione primo/ultimo fotogramma: first_frame_url specifica da solo il fotogramma di apertura; fornendo contemporaneamente first_frame_url e last_frame_url è possibile generare una transizione tra fotogrammi di inizio e fine, con una durata massima di 10 secondi e senza poter usare contemporaneamente immagini di riferimento.
Impostazioni di durata, formato e risoluzione: duration è un numero intero di secondi da 3 a 15, con valore predefinito 10 secondi; aspect_ratio può essere 16:9 o 9:16; resolution può essere 360p, 720p, 1080p o 4k, con valore predefinito 720p.
Stile complessivo ed esclusione di contenuti: system_prompt serve a impostare lo stile visivo complessivo, mentre negative_prompt descrive i contenuti da escludere; quando si specifica il fotogramma finale, queste due opzioni non sono disponibili.
Scenari di utilizzo
- Team e-commerce che realizzano brevi video dimostrativi di prodotto — generano brevi video orizzontali con prompt e più immagini di riferimento di prodotti o persone, da usare come materiali di presentazione nelle pagine di dettaglio e nei riquadri prodotto.
- Team advertising che producono materiali pubblicitari verticali — descrivono i punti di forza con un prompt e scelgono il formato 9:16 per generare video adatti alla pubblicazione verticale nei feed e sulle piattaforme di video brevi.
- Team di design che trasformano immagini statiche in animazioni — impostano un'immagine pubblica come primo fotogramma per generare una clip in movimento che si sviluppa da quella scena, utile per animare poster o illustrazioni.
- Team creativi che previsualizzano l'inizio e la fine delle inquadrature — forniscono primo e ultimo fotogramma per generare una transizione, utile per la previsualizzazione dello storyboard e la rapida presentazione di concept clip.
Limiti e suggerimenti per la scelta
La durata di un singolo video è limitata da 3 a 15 secondi, con un massimo di 10 secondi in modalità primo/ultimo fotogramma; per contenuti più lunghi è necessario procedere per segmenti. 1080p e 4k sono output ingranditi e il 4k potrebbe non includere una traccia audio. Le immagini di riferimento sono mutuamente esclusive con primo e ultimo fotogramma; dopo aver specificato il fotogramma finale non è possibile usare system_prompt e negative_prompt. Tutti i parametri immagine accettano esclusivamente URL HTTP(S) pubblici e non supportano Base64.
Novità
Vedi il changelog →- Nuovo modello Gemini Omni 1.2 Flash è online: generazione video da testo, primo frame e immagini di riferimento
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: gemini-omni-1.2-flash
routestringOpzionaleValore fisso attuale: default
inputobjectObbligatorio
Oggetto di parametri di business per gemini-omni-1.2-flash e la route default — vedi la tabella dei parametri sotto.
promptstringObbligatoriominLength 1maxLength 20000pattern \SPrompt che descrive la scena, il movimento, la camera e i suoni desiderati; supporta fino a 20.000 caratteri ed è obbligatorio fornire un prompt con contenuto non vuoto in qualsiasi modalità.
durationintegerOpzionalePredefinito: 10min 3max 15Durata del video di output, espressa in secondi interi tra 3 e 15; quando si utilizza l'interpolazione tra primo e ultimo fotogramma il limite massimo è di 10 secondi. Predefinito: 10 secondi.
image_urlsarrayOpzionaleminItems 1maxItems 10Array di immagini di riferimento, i cui elementi sono URL di immagini; è possibile utilizzare da 1 a 10 immagini come riferimento per personaggi, prodotti o stile; passare un'immagine tramite questo parametro rientra comunque nella modalità immagine di riferimento, mentre se si desidera usare una singola immagine come fotogramma iniziale occorre utilizzare first_frame_url. Sono supportati solo indirizzi HTTP(S) di immagini accessibili direttamente dalla rete pubblica, Base64 non è supportato; non può essere usato insieme al primo o all'ultimo fotogramma.
Array [ string ]
resolutionstringOpzionalePredefinito: "720p"Risoluzione di output; 1080p e 4k sono output con upscaling, l'output 4k potrebbe non includere la traccia audio. Predefinito: 720p.
360p720p1080p4kaspect_ratiostringOpzionalePredefinito: "16:9"Proporzioni dell'immagine di output, che determinano la composizione orizzontale o verticale. Predefinito: 16:9.
16:99:16system_promptstringOpzionalePrompt di sistema, utilizzato per impostare lo stile complessivo o la direzione visiva; non può essere usato insieme all'ultimo fotogramma.
last_frame_urlstringOpzionaleminLength 1pattern ^https?://Indirizzo dell'immagine dell'ultimo fotogramma, da fornire insieme a first_frame_url; in questo caso la durata massima è di 10 secondi; sono supportati solo indirizzi HTTP(S) di immagini accessibili direttamente dalla rete pubblica, Base64 non è supportato; non può essere usato insieme a immagini di riferimento, system_prompt o negative_prompt.
first_frame_urlstringOpzionaleminLength 1pattern ^https?://Indirizzo dell'immagine del primo fotogramma del video, che può essere specificato da solo per impostare il fotogramma iniziale; è necessario utilizzare un URL HTTP(S) di immagine accessibile direttamente dalla rete pubblica, Base64 non è supportato e non può essere usato insieme a image_urls; è obbligatorio quando viene fornito last_frame_url.
negative_promptstringOpzionalePrompt negativo, utilizzato per descrivere i contenuti da escludere; non può essere usato insieme all'ultimo fotogramma.
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": "gemini-omni-1.2-flash",
"input": {
"prompt": "…",
"duration": 10,
"resolution": "720p",
"aspect_ratio": "16:9"
}
}' 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: "gemini-omni-1.2-flash",
input: {
"prompt": "…",
"duration": 10,
"resolution": "720p",
"aspect_ratio": "16:9"
}
}),
});
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": "gemini-omni-1.2-flash",
"input": {
"prompt": "…",
"duration": 10,
"resolution": "720p",
"aspect_ratio": "16:9"
}
},
)
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
Checklist di selezione di Gemini Omni 1.2 Flash: modalità di input, specifiche e budget
Verifica modalità di input, specifiche, budget e confini degli effetti, e completa la validazione di selezione con i tuoi campioni
-
Tutoriale
gemini-omni-1.2-flash in pratica: 3 scenari aziendali di generazione video e una checklist di implementazione
Tre casi d'uso applicativi: creatività testuale, animazione di primo frame e vincolo visivo tramite immagini di riferimento
-
Guida all'uso
Guida all'integrazione di Gemini Omni 1.2 Flash: modalità di input, parametri e fatturazione per specifica
Percorso di integrazione minimo per il modello pubblico gemini-omni-1.2-flash: modalità di input, vincoli dei parametri, richieste copiabili e fatturazione per risoluzione
Modelli correlati
Vedi tutti i modelli →Stesso tipo
-
MiniMax H3 MiniMax $0.072 /secondo -
HappyHorse 1.0 Alibaba $0.168 /secondo -
PixVerse V6 PixVerse $0.036 /secondo -
FLUX 3 Max Black Forest Labs $0.121 /secondo -
LTX 2.5 Fast Lightricks $0.086 /secondo -
HappyHorse 1.1 Alibaba $0.160 /secondo -
Veo 3.1 Fast Google $0.170 /secondo -
Ray 3.2 Luma $0.214 /video -
Kling 3.0 Turbo Kuaishou $0.144 /secondo -
Vidu Q4 Preview Vidu $0.051 /secondo -
Grok Imagine 1.5 Lite xAI $0.029 /secondo -
Kling 2.5 Kuaishou $0.090 /secondo
Stesso fornitore
-
Nano Banana Google $0.011 /immagine -
Lyria 3.5 Google $0.090 /brano -
Nano Banana 2 Google $0.018 /immagine -
Gemini Omni 1.1 Flash Google $0.450 /video -
Nano Banana 2 Lite Google $0.033 /immagine -
Google Virtual Try-On Google $0.107 /immagine -
Veo 3.1 Lite Google $0.060 /secondo -
Imagen 4 Google $0.030 /immagine -
Veo 3.1 Fast Google $0.170 /secondo -
Nano Banana Pro Google $0.029 /immagine -
Lyria 3 Pro Google $0.140 /brano -
Veo 3.1 Google $0.290 /secondo
