Gemini Omni 1.2 Flash

2026-11-07 tarihinde doğrulanan gemini-omni-1.2-flash APIMaster ağ geçidi sözleşmesi. Yerel Google Interactions API değildir; 1.1 Official/Ext kuralları uygulanmaz.

OpenAPI 3.1 · Gemini Omni 1.2 Flash

Uç noktalar ve kimlik doğrulama

Geçerli açık rota kanal 335'tir. Authorization: Bearer YOUR_API_KEY ve Content-Type: application/json kullanın. Model/grup izinleri, bakiye ve rota kullanılabilirliği geçerlidir; ek müşteri izin listesi yayımlanmamıştır. Model kimliğine kanal numarası eklemeyin. Ayrı bir 1.2 Ext rotası yoktur. Model listesi Google'ın tüm özelliklerinin sunulduğu anlamına gelmez.

• 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

Parametreler ve sınırlar

Alan	Tür	Kural
model	string	Tam açık model kimliği.
prompt	string	Düzenleme ve devam dahil her modda boş olmayan yönerge zorunludur. Üretilecek sesi burada açıklayın.
duration	integer	Varsayılan 10. Normal üretim tam sayı 3–15 saniye; ilk/son kare enterpolasyonu ve uzatmanın yeni bölümü 3–10. Düzenlemede yok sayılır.
seconds	integer / string	duration için tam sayı veya tam sayı metni takma adı. İkisi varsa duration önceliklidir.
resolution	string	360p, 720p (varsayılan), 1080p, 4k; büyük/küçük harf duyarsız. 2160p, 4k olur. 1080p/4k yükseltilmiş çözünürlüktür.
aspect_ratio	string	16:9 (varsayılan) veya 9:16. Diğer metin değerleri şu an 16:9'a dönüştürülür.
ratio	string	Eski en-boy oranı takma adı, çözünürlük değil. aspect_ratio tercih edin.
size	string	En-boy oranı takma adı; öncelik aspect_ratio, ratio, size.
image_urls	string[]	Açık HTTP(S) görsel URL dizisi. Genelde bir görsel başlangıç, birden fazlası referanstır.
first_frame_image	string	İlk karenin açık URL'si.
last_frame_image	string	first_frame_image gerektirir; kare oranını çıktıyla eşleştirin.
image_with_roles	object[]	Açık kare alanlarının alternatifi; birlikte kullanılamaz. Her nesnede url ve boş olmayan role. first_frame/last_frame karedir; diğer roller referans. Son kare için ilk kare gerekir.
video_urls	string[]	En fazla bir açık giriş videosu, en çok 15 saniye. Varsayılan düzenleme.
omni_reference_task_type	string	auto, edit, extend, reference, text_to_video, image_to_video, reference_to_video. Uzatma için açıkça extend gerekir.
extend_from_task_id	string	Aynı hesap/modelin tamamlanmış açık görev kimliği. video_urls ile kullanılamaz. Asıl kanal/hesap kullanılabilir olmalı. Google interaction ID değildir.

Görsel ve kare toplamı en fazla 10. image_with_roles veya açık kare alanlarını seçin. Sağlayıcı en fazla iki karakter ve karakter başına üç görsel önerir. Yalnızca doğrudan açık HTTP(S) URL; Base64, Data URL ve multipart yok. PNG/JPEG ve MP4 doğrulandı. Süre denetimi MP4/MOV uyumlu medyadan en fazla 100 MiB okur; bu, sağlayıcının garanti ettiği yükleme sınırı değildir. Görsel başına boyut ve eksiksiz codec/boyut sözleşmesi kesinleşmemiştir.

Ses referansları, audio_urls, Google interaction/conversation durumu, metadata, generation_type, system_prompt, temperature, negative_prompt, seed, fps, n desteklenmez. Olumsuz yönergeleri ve üretilecek sesi prompt içine yazın. Tamamlanmış açık görevler zincirlenebilir ancak her giriş videosu en çok 15 saniyedir; Google'ın yerel çok turlu konuşması değildir. Bilinmeyen üst düzey alanlar reddedilir.

Çalıştırılmayan JSON örnekleri

Bunlar çalıştırılmayan JSON gövdeleridir, betik değildir. example.com ve örnek kimlikleri değiştirin. Yeni işlemde yeni anahtar; yeniden denemede aynı anahtar ve gövde kullanın. Sonraki devam için tamamlanan alt görevin açık kimliğini kullanın. Geçerli ses girdisi örneği yoktur.

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"}

Görev sorgulama ve indirme

İlk kabul edilen POST, HTTP 200 ve queued döndürür. Her 5–10 saniyede sorgulayın: queued → in_progress → completed/failed; geçici unknown durumunu da karşılayın. url ve metadata.url kimlik doğrulamalı vekildir, indirme de Bearer ister. Üretim hatası genelde HTTP 200 ve error.code=generation_failed ile temizlenmiş ileti döndürür. Gönderim hataları 4xx/5xx kullanır. Zaman aşımı veya 5xx, kabul edilmediğini kanıtlamaz. Aşağıdaki örneklerin kimlik ve zamanları değiştirilmiştir.

{"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."}}

Kullanım, son ücret ve iadeler

Görev yanıtında usage, modalite ayrıntısı veya USD garanti edilmez. Mutabakat sonrası son müşteri ücreti tüketim günlüğündeki other.final_amount_usd alanıdır. Aynı anahtarla GET /api/log/token sınırlı yakın geçmişi döndürür; tam fatura arşivi değildir. GET /api/log/self hesap kimlik doğrulaması ister. other alanını JSON olarak ayrıştırıp other.task_id ile eşleştirin. Gerçek kullanımda prompt_tokens, completion_tokens ve other.input_tokens, text_output_tokens, video_output_tokens, token_usage_source, retail_token_prices, group_ratio bulunabilir. Girdi topludur; metin/görsel/video ayrıntısı garanti değildir.

2026-11-07 itibarıyla kanal 335 temel satış fiyatları milyon token başına girdi $1.32, metin çıktısı $7.92, video çıktısı $10.56; hesap çarpanı öncesidir. Güncel kartı kontrol edin. Tahmini tutar ayrılır, sabitlenmiş tarife ve gerçek kullanımla ek tahsilat/iade yapılır. Doğrulanmış üretim hatasında rezerv iade edilir; kabul belirsizse hemen iade garantisi yoktur. 500,000 quota = USD 1. İlk rezerv son fatura değildir; son tutar ve düzeltmeleri tekrar toplamayın. Tarihsel örnek: girdi 39, metin 0, video 5793, $0.064286; yeni istek için sabit teklif değildir.

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

Uzatma, yeni bölümün video çıktısını ve referans videonun girdisini ücretlendirir; birleşik dosyanın tamamını yeni çıktı saymaz. Doğrulanan 3+3 saniye örneğinde yaklaşık 6 saniyelik dosya, 3 saniyelik yeni çıktı vardır. Üretilen ses video çıktısına dahildir. Metin ayrıntısı yoksa mevcut ayrıştırıcı bildirilen çıktıyı video kabul eder. Geçerli token sayısı yok fakat güvenilir sağlayıcı maliyet makbuzu varsa token_usage_source=provider_cost_receipt ile, sayaç uydurmadan hesaplaşabilir. İkisi de yoksa mutabakat sürer. Eksiksiz sayaç ve sabit hesaplaşma süresi garanti edilmez.

Ağ geçidi idempotansı ve kurtarma

Idempotency-Key boşluksuz 8–128 görünür ASCII karakteridir, hesap kapsamında olup gövdede karşılığı yoktur. Aynı anahtar/istek HTTP 202 ve Idempotency-Replayed:true döndürür; ikinci üretim/rezerv olmaz. Gövde, grup veya açık rota değişikliği 409 idempotency_conflict verir. JSON anahtar sırası önemsiz; dizi sırası ve atlanmış/açık varsayılanlar önemlidir. Bağlantı kopunca ağ geçidi ilk gönderimi ve kaydı sınırlı süre içinde tamamlamaya çalışır.

{"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"}}

Asıl anahtar ve Bearer ile GET /v1/video-submissions/by-key yalnız makbuzu okur; üretim, sağlayıcı araması veya para hareketi yapmaz. pending/submitting: sorgulamayı sürdürün; accepted ve task_ready=true: task_id sorgulayın; hazır değilse mutabakat/destek bekleyin. acceptance_unknown: otomatik yeniden göndermeyin, anahtar ve referansı saklayın. not_accepted: doğrulanmış hatayı düzeltin ve yalnız makbuz/para durumu izin veriyorsa yeni anahtar kullanın. Eski anahtar eski sonucu oynatır. 404 ve retry_safe=false, kabul edilmediğini kanıtlamaz. En az 30 gün saklama; otomatik anahtar yeniden kullanımı yoktur. Müşteri anahtarsız tekrar POST yeni işlemdir. Bu Google/APIMart yerel özelliği değil, ağ geçidi idempotansıdır; belirsiz istekler yeniden gönderilmez. Kabulü ve mali kaydı kesinleşen kayıtlar yeniden üretim/ücret olmadan kurtarılabilir.

Desteklenmeyen özellikler ve fiyat tahmini

POST /v1/videos/quote bu modeli DESTEKLEMEZ; mevcut doğrulama Seedance'a özeldir. Omni için ücretsiz, görev oluşturmayan ve üreticiyi çağırmayan teklif sözleşmesi, özel invoice veya son fatura olarak /v1/videos/{task_id}/billing yoktur. Sağlayıcının moderasyon ve bölge kuralları geçerlidir; EEA, İsviçre ve Birleşik Krallık'ta yüklenen videoların düzenlenmesi/uzatılması kısıtlanabilir. Bağlantılı şema ağ geçidini tanımlar; yerel örnekler APIMaster kimlik/yanıt/günlüklerinin yerine geçmez.

APIMart · Gemini Omni 1.2 Flash