Gemini Omni 1.2 Flash

Contratto del gateway APIMaster per gemini-omni-1.2-flash, verificato il 2026-11-07. Non è l'API nativa Google Interactions; le regole Official/Ext di 1.1 non si applicano.

OpenAPI 3.1 · Gemini Omni 1.2 Flash

Rotte e autenticazione

La rotta pubblica attuale è il canale 335. Usare Authorization: Bearer YOUR_API_KEY e Content-Type: application/json. Restano validi permessi di modello/gruppo, saldo e disponibilità; non è pubblicato un ulteriore elenco di clienti autorizzati. Non aggiungere il canale all'ID. Non esiste una rotta Ext separata per 1.2; la presenza nell'elenco non espone tutte le capacità Google.

• POST https://apimaster.ai/v1/videos
• POST https://apimaster.ai/v1/videos/generations
• GET https://apimaster.ai/v1/videos/{task_id}
• GET https://apimaster.ai/v1/videos/{task_id}/content
• GET https://apimaster.ai/v1/video-submissions/by-key
• GET https://apimaster.ai/api/log/token

Parametri e limiti

Campo	Tipo	Regola
model	string	ID pubblico esatto del modello.
prompt	string	Istruzione non vuota obbligatoria in ogni modalità, anche modifica e continuazione.
duration	integer	Predefinito 10; generazione ordinaria 3–15 secondi interi; interpolazione e nuovo segmento di estensione 3–10. Ignorato nella modifica.
seconds	integer / string	Alias compatibile di duration, intero o stringa intera; duration prevale se presenti entrambi.
resolution	string	360p, 720p (predefinito), 1080p, 4k, senza distinzione maiuscole; 2160p diventa 4k. 1080p/4k sono ricampionati.
aspect_ratio	string	16:9 predefinito o 9:16; altre stringhe sono attualmente normalizzate a 16:9. Usare solo i valori supportati.
ratio	string	Vecchio alias del rapporto, non della risoluzione; preferire aspect_ratio.
size	string	Vecchio alias; precedenza aspect_ratio, ratio, size.
image_urls	string[]	URL pubblici HTTP(S) di immagini; una immagine è il fotogramma iniziale predefinito, più immagini sono riferimenti.
first_frame_image	string	URL pubblico del primo fotogramma.
last_frame_image	string	Richiede first_frame_image; proporzioni coerenti con l'uscita.
image_with_roles	object[]	Alternativa ai campi dei fotogrammi. Ogni oggetto ha url e role non vuoto: first_frame/last_frame sono estremi, gli altri ruoli riferimenti. L'ultimo richiede il primo.
video_urls	string[]	Al massimo un video pubblico in ingresso di 15 secondi; modifica predefinita.
omni_reference_task_type	string	auto, edit, extend, reference, text_to_video, image_to_video, reference_to_video. L'estensione richiede extend esplicito.
extend_from_task_id	string	ID pubblico task_... di una propria attività riuscita di questo modello; esclude video_urls. Rotta e account originali devono restare disponibili. Non un Google interaction ID.

Massimo 10 immagini totali, inclusi i fotogrammi. Scegliere image_with_roles oppure i campi espliciti. Il fornitore consiglia al massimo due personaggi con tre immagini ciascuno. Solo URL HTTP(S) pubblici diretti, senza Base64, Data URL o multipart. PNG/JPEG e MP4 sono stati verificati. La misura della durata supporta media compatibili MP4/MOV e legge al massimo 100 MiB: non è un limite di caricamento garantito dal fornitore. Non sono pubblicati un limite per immagine o un contratto completo di codec e dimensioni.

Non sono supportati riferimenti audio, audio_urls, stato Google interaction/conversation, metadata, generation_type, system_prompt, temperature, negative_prompt, seed, fps o n. Inserire requisiti negativi e audio desiderato in prompt. Si possono concatenare attività pubbliche concluse, ma ogni video in ingresso resta limitato a 15 secondi; non è una sessione nativa Google. I campi superiori sconosciuti sono rifiutati.

Esempi JSON non eseguibili

Sono solo corpi JSON inerti. Sostituire example.com e gli ID illustrativi. Ogni nuova operazione usa una nuova chiave; il tentativo ripetuto conserva chiave e corpo. Per il turno successivo usare l'ID pubblico dell'attività figlia conclusa. Non esiste un esempio valido di audio in ingresso.

1. text_to_video

{"model":"gemini-omni-1.2-flash","prompt":"A blue glass sphere rolls slowly across a plain gray table.","duration":3,"resolution":"360p","aspect_ratio":"16:9"}

2. reference_to_video

{"model":"gemini-omni-1.2-flash","prompt":"Animate these geometric references while preserving their shapes and colors.","image_urls":["https://example.com/reference-a.png","https://example.com/reference-b.png"],"omni_reference_task_type":"reference","duration":6,"resolution":"720p","aspect_ratio":"16:9"}

3. first_frame_image / last_frame_image

{"model":"gemini-omni-1.2-flash","prompt":"Make a smooth transition from the first view to the last view.","first_frame_image":"https://example.com/first.png","last_frame_image":"https://example.com/last.png","duration":6,"resolution":"720p","aspect_ratio":"16:9"}

4. image_with_roles

{"model":"gemini-omni-1.2-flash","prompt":"Make a smooth transition between these views.","image_with_roles":[{"url":"https://example.com/first.png","role":"first_frame"},{"url":"https://example.com/last.png","role":"last_frame"}],"duration":6,"resolution":"720p"}

5. edit / video_urls

{"model":"gemini-omni-1.2-flash","prompt":"Change the lighting to sunset while preserving the scene.","video_urls":["https://example.com/input.mp4"],"omni_reference_task_type":"edit","resolution":"720p"}

6. extend / video_urls

{"model":"gemini-omni-1.2-flash","prompt":"Continue the camera movement for three more seconds.","video_urls":["https://example.com/input.mp4"],"omni_reference_task_type":"extend","duration":3,"resolution":"720p"}

7. extend / extend_from_task_id

{"model":"gemini-omni-1.2-flash","prompt":"Continue the previous scene with a gentle camera pan.","extend_from_task_id":"task_YOUR_COMPLETED_TASK","omni_reference_task_type":"extend","duration":3,"resolution":"720p"}

8. edit / extend_from_task_id

{"model":"gemini-omni-1.2-flash","prompt":"Keep the scene but turn the blue sphere yellow.","extend_from_task_id":"task_YOUR_COMPLETED_TASK","omni_reference_task_type":"edit","resolution":"720p"}

Attività, interrogazione e download

Il primo POST accettato restituisce HTTP 200 e queued. Interrogare ogni 5–10 secondi: queued → in_progress → completed/failed; gestire anche unknown transitorio. url e metadata.url sono proxy autenticati: scaricare con Bearer. Un errore di generazione normalmente restituisce HTTP 200 e error.code=generation_failed, con messaggio sanificato. Gli errori di invio usano 4xx/5xx. Timeout o 5xx non provano la mancata accettazione. Gli esempi sostituiscono identità e data.

{"id":"task_REDACTED_EXAMPLE","task_id":"task_REDACTED_EXAMPLE","object":"video","model":"gemini-omni-1.2-flash","status":"queued"}

{"id":"task_REDACTED_COMPLETED_EXAMPLE","task_id":"task_REDACTED_COMPLETED_EXAMPLE","object":"video","model":"gemini-omni-1.2-flash","status":"completed","progress":100,"created_at":1793966808,"url":"https://apimaster.ai/v1/videos/task_REDACTED_COMPLETED_EXAMPLE/content","metadata":{"url":"https://apimaster.ai/v1/videos/task_REDACTED_COMPLETED_EXAMPLE/content"}}

{"id":"task_REDACTED_FAILED_EXAMPLE","task_id":"task_REDACTED_FAILED_EXAMPLE","object":"video","model":"gemini-omni-1.2-flash","status":"failed","progress":100,"created_at":1793966808,"error":{"code":"generation_failed","message":"The generation request failed."}}

Utilizzo, costo finale e rimborsi

L'interrogazione non garantisce usage, dettagli delle modalità o USD. Dopo la riconciliazione il costo finale cliente è other.final_amount_usd nel registro consumi. GET /api/log/token con la stessa chiave restituisce una lista recente limitata, non un archivio fatture. GET /api/log/self richiede autenticazione dell'account per la cronologia; la chiave di generazione non la sostituisce. Analizzare other come JSON e associare other.task_id. Quando disponibili: prompt_tokens, completion_tokens e other.input_tokens, text_output_tokens, video_output_tokens, token_usage_source, retail_token_prices, group_ratio. L'ingresso è aggregato, senza ripartizione testo/immagine/video garantita.

Al 2026-11-07 le tariffe base del canale 335 sono $1.32 ingresso, $7.92 testo e $10.56 video per milione di token, prima dei moltiplicatori dell'account; consultare la scheda corrente. All'invio si riserva una stima, poi uso reale e prezzi congelati determinano integrazione o rimborso. Il fallimento confermato restituisce la riserva; l'accettazione incerta non garantisce rimborso immediato. 500,000 quota = USD 1. La riserva iniziale non è il totale finale; non sommare nuovamente gli aggiustamenti al costo finale. Esempio storico: ingresso 39, testo 0, video 5793, finale $0.064286; non è un prezzo fisso nuovo.

USD = (input_tokens × input_rate
     + text_output_tokens × text_output_rate
     + video_output_tokens × video_output_rate) / 1,000,000

L'estensione addebita l'uscita video del nuovo segmento e l'ingresso del riferimento; il file MP4 contiene entrambi. Verificati 3 secondi iniziali più 3 nuovi: file di circa 6 secondi, token di uscita per circa 3 nuovi. L'audio generato appartiene all'uscita video. In assenza di dettaglio testuale, il parser attuale considera l'uscita dichiarata come video. Senza token validi ma con ricevuta di costo autorevole, può liquidare tramite ricevuta, token_usage_source=provider_cost_receipt, senza inventare conteggi. Senza uso né costo continua la riconciliazione. Non sono garantiti conteggi completi o tempi fissi.

Idempotenza del gateway e recupero

Idempotency-Key: 8–128 caratteri ASCII visibili senza spazi, senza equivalente nel corpo, isolato per account. Stesso account/chiave/richiesta: HTTP 202 e Idempotency-Replayed:true, senza seconda generazione o riserva. Modifica di corpo, gruppo o rotta esplicita: 409 idempotency_conflict. L'ordine delle chiavi JSON è ignorato; valori, ordine degli array e valori predefiniti omessi/espliciti contano. Dopo disconnessione, il gateway cerca di concludere l'invio originale e la persistenza entro l'esecuzione limitata.

{"code":200,"data":{"submission_id":"REDACTED_SUBMISSION_ID","task_id":"task_REDACTED_EXAMPLE","model":"gemini-omni-1.2-flash","status":"accepted","task_ready":true,"same_key_replay_safe":true,"new_submission_safe":false,"next_action":"query_task"}}

GET /v1/video-submissions/by-key con chiave originale e Bearer legge solo la ricevuta: nessun generatore, ricerca per chiave dal fornitore o movimento di fondi. pending/submitting: continuare a leggere; accepted con task_ready=true: interrogare task_id; accepted non pronto: attendere riconciliazione o supporto; acceptance_unknown: non reinviare automaticamente, conservare chiave e riferimento; not_accepted: correggere l'errore confermato e usare una nuova chiave solo se ricevuta e fondi lo consentono. La chiave vecchia riproduce sempre il risultato originale. Un 404 con retry_safe=false non prova mancata accettazione. Conservazione minima 30 giorni senza riutilizzo automatico. Ripetere POST senza chiave cliente crea una nuova operazione. È idempotenza del gateway, non nativa Google/APIMart. Gli originali incerti non vengono reinviati automaticamente; attività accettate e finanziariamente confermate possono essere ripristinate senza nuova generazione o addebito.

Funzionalità non disponibili e preventivi

POST /v1/videos/quote NON supporta questo modello: la verifica attuale è specifica Seedance. Non esiste un preventivo Omni gratuito supportato senza attività/generatore, né invoice dedicato o /v1/videos/{task_id}/billing come fattura finale. Restano applicabili moderazione e limiti regionali del fornitore, compresi editing/estensione dei video caricati in EEA, Svizzera e Regno Unito. Lo schema collegato descrive il gateway; gli esempi nativi non sostituiscono ID, risposte e registri APIMaster.

APIMart · Gemini Omni 1.2 Flash