Gemini Omni 1.2 Flash

Kontrak gateway APIMaster untuk gemini-omni-1.2-flash, diperiksa pada 2026-11-07. Ini bukan API Google Interactions asli; aturan Official/Ext 1.1 tidak berlaku.

OpenAPI 3.1 · Gemini Omni 1.2 Flash

Endpoint dan autentikasi

Rute publik saat ini adalah kanal 335. Gunakan Authorization: Bearer YOUR_API_KEY dan Content-Type: application/json. Izin model/grup, saldo, dan ketersediaan rute tetap berlaku; tidak ada daftar izin pelanggan tambahan yang dipublikasikan. Jangan tambahkan kanal pada ID model. Tidak ada rute Ext 1.2 terpisah. Daftar model tidak berarti semua kemampuan Google tersedia.

• 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

Parameter dan batasan

Kolom	Tipe	Aturan
model	string	ID model publik yang persis sama.
prompt	string	Instruksi tidak kosong wajib untuk semua mode, termasuk penyuntingan dan kelanjutan. Jelaskan suara yang ingin dihasilkan di sini.
duration	integer	Bawaan 10. Generasi biasa 3–15 detik bulat; interpolasi bingkai awal/akhir dan segmen baru perpanjangan 3–10. Diabaikan saat menyunting.
seconds	integer / string	Alias duration berupa bilangan bulat atau string bilangan bulat; duration diprioritaskan bila keduanya ada.
resolution	string	360p, 720p (bawaan), 1080p, 4k; tidak peka huruf besar. 2160p menjadi 4k. 1080p/4k ditingkatkan resolusinya.
aspect_ratio	string	16:9 (bawaan) atau 9:16. String lain saat ini dinormalisasi ke 16:9.
ratio	string	Alias rasio aspek lama, bukan resolusi. Utamakan aspect_ratio.
size	string	Alias rasio aspek; urutan prioritas aspect_ratio, ratio, size.
image_urls	string[]	Array URL gambar HTTP(S) publik. Satu gambar biasanya gambar awal, beberapa gambar menjadi referensi.
first_frame_image	string	URL publik bingkai pertama.
last_frame_image	string	Memerlukan first_frame_image; sesuaikan rasio bingkai dengan keluaran.
image_with_roles	object[]	Alternatif untuk kolom bingkai eksplisit, tidak boleh digabung. Setiap objek memiliki url dan role tidak kosong. first_frame/last_frame adalah bingkai; lainnya referensi. Bingkai akhir memerlukan awal.
video_urls	string[]	Maksimal satu video publik berdurasi sampai 15 detik. Bawaan: penyuntingan.
omni_reference_task_type	string	auto, edit, extend, reference, text_to_video, image_to_video, reference_to_video. Perpanjangan memerlukan extend eksplisit.
extend_from_task_id	string	ID tugas publik yang selesai, dari akun dan model yang sama. Tidak boleh bersama video_urls. Kanal dan akun asli harus tersedia. Bukan Google interaction ID.

Gabungan gambar dan bingkai maksimal 10. Pilih image_with_roles atau kolom bingkai eksplisit. Pemasok menyarankan maksimal dua tokoh dan tiga gambar per tokoh. Hanya URL HTTP(S) publik langsung; tanpa Base64, Data URL, atau multipart. PNG/JPEG dan MP4 telah divalidasi. Pemeriksaan durasi membaca media kompatibel MP4/MOV sampai 100 MiB; ini bukan batas unggahan yang dijamin pemasok. Batas per gambar dan daftar lengkap codec/ukuran belum ditetapkan.

Referensi audio, audio_urls, status Google interaction/conversation, metadata, generation_type, system_prompt, temperature, negative_prompt, seed, fps, dan n tidak didukung. Tulis larangan dan suara yang diinginkan dalam prompt. Tugas publik selesai dapat dirangkai, tetapi setiap video masukan tetap maksimal 15 detik; ini bukan percakapan Google asli. Kolom tingkat atas yang tidak dikenal ditolak.

Contoh JSON yang tidak dijalankan

Berikut badan JSON yang tidak dijalankan, bukan skrip. Ganti example.com dan ID contoh. Operasi baru memakai kunci baru; percobaan ulang mempertahankan kunci dan badan yang sama. Kelanjutan berikutnya memakai ID publik tugas anak yang selesai. Tidak ada contoh valid masukan audio.

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

Pemeriksaan tugas dan unduhan

POST pertama yang diterima mengembalikan HTTP 200 dan queued. Periksa setiap 5–10 detik: queued → in_progress → completed/failed; tangani juga unknown sementara. url dan metadata.url adalah proksi terautentikasi, unduh dengan Bearer. Kegagalan generasi biasanya HTTP 200 dengan error.code=generation_failed dan pesan yang disanitasi. Kesalahan pengiriman memakai 4xx/5xx. Timeout atau 5xx bukan bukti bahwa tugas tidak diterima. ID dan waktu pada contoh berikut telah diganti.

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

Penggunaan, biaya akhir, dan pengembalian dana

Respons tugas tidak menjamin usage, rincian modalitas, atau USD. Biaya akhir pelanggan setelah rekonsiliasi adalah other.final_amount_usd pada log konsumsi. GET /api/log/token dengan kunci yang sama mengembalikan daftar terbaru yang terbatas, bukan arsip faktur. GET /api/log/self memerlukan autentikasi akun. Urai other sebagai JSON dan cocokkan other.task_id. Penggunaan nyata dapat mencakup prompt_tokens, completion_tokens serta other.input_tokens, text_output_tokens, video_output_tokens, token_usage_source, retail_token_prices, group_ratio. Masukan bersifat agregat, tanpa jaminan rincian teks/gambar/video.

Pada 2026-11-07, tarif jual dasar kanal 335 per sejuta token adalah masukan $1.32, keluaran teks $7.92, video $10.56, sebelum pengali akun. Periksa kartu terbaru. Estimasi dicadangkan lalu direkonsiliasi memakai tarif yang dibekukan dan penggunaan nyata, dengan tagihan tambahan atau pengembalian. Kegagalan generasi yang terkonfirmasi mengembalikan cadangan; penerimaan tidak pasti tidak menjamin pengembalian segera. 500,000 quota = USD 1. Cadangan awal bukan tagihan akhir; jangan menjumlahkan lagi nilai akhir dengan penyesuaiannya. Contoh historis: masukan 39, teks 0, video 5793, $0.064286; bukan estimasi tetap permintaan baru.

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

Perpanjangan menagih keluaran video segmen baru serta masukan video referensi, meskipun MP4 menggabungkan keduanya. Pengujian 3 detik + 3 detik menghasilkan berkas sekitar 6 detik dengan keluaran baru sekitar 3 detik. Audio yang dihasilkan termasuk keluaran video. Tanpa rincian teks, parser saat ini menganggap keluaran yang dilaporkan sebagai video. Jika token valid tidak tersedia tetapi ada bukti biaya pemasok yang sah, rekonsiliasi dapat memakai token_usage_source=provider_cost_receipt tanpa mengarang hitungan token. Tanpa keduanya rekonsiliasi berlanjut. Tidak ada jaminan seluruh rincian atau waktu penyelesaian tetap.

Idempotensi gateway dan pemulihan

Idempotency-Key berisi 8–128 karakter ASCII terlihat tanpa spasi, terisolasi per akun dan tanpa kolom badan. Kunci/permintaan yang sama mengembalikan HTTP 202 dan Idempotency-Replayed:true tanpa generasi atau cadangan kedua. Perubahan badan, grup, atau rute eksplisit menghasilkan 409 idempotency_conflict. Urutan kunci JSON diabaikan; urutan array serta nilai bawaan dihilangkan/dinyatakan berpengaruh. Setelah koneksi putus gateway mencoba menyelesaikan pengiriman asli dan penyimpanan dalam batas waktunya.

{"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 memakai kunci asli dan Bearer hanya membaca tanda terima: tanpa generasi, pencarian pemasok, atau perubahan dana. pending/submitting: periksa lagi; accepted dengan task_ready=true: periksa task_id; accepted belum siap: tunggu rekonsiliasi atau hubungi dukungan. acceptance_unknown: jangan kirim ulang otomatis, simpan kunci dan referensi. not_accepted: perbaiki kesalahan terkonfirmasi dan gunakan kunci baru hanya jika status tanda terima/dana mengizinkan. Kunci lama tetap mengulang hasil asli. 404 dengan retry_safe=false bukan bukti tidak diterima. Retensi minimal 30 hari, tanpa penggunaan ulang otomatis. POST ulang tanpa kunci pelanggan adalah operasi baru. Ini idempotensi gateway, bukan Google/APIMart asli; pengiriman tidak pasti tidak dikirim ulang. Catatan yang telah diterima dan dikonfirmasi secara finansial dapat dipulihkan tanpa generasi/tagihan baru.

Fitur yang tidak didukung dan estimasi

POST /v1/videos/quote TIDAK mendukung model ini; validasinya saat ini khusus Seedance. Tidak ada kontrak estimasi Omni gratis tanpa tugas/panggilan generator, faktur khusus, atau /v1/videos/{task_id}/billing sebagai tagihan akhir. Moderasi dan batas regional pemasok berlaku, termasuk pembatasan edit/perpanjangan video unggahan di EEA, Swiss, dan Inggris. Skema tertaut menjelaskan gateway; contoh asli pemasok tidak menggantikan ID, respons, atau log APIMaster.

APIMart · Gemini Omni 1.2 Flash