Integrasi API Gemini Omni 1.1 Flash
Gunakan Gemini Omni 1.1 Flash melalui Rivya Public API v1 dengan id model gemini-omni-flash-1-1, input yang didukung, parameter, aturan Files API, kredit, dan contoh response.
gemini-omni-flash-1-1
text, file
Diperlukan untuk mode referensi
per_video · 4=45 · 6=60 · 8=75 · 10=90 · 4k_4=105 · 4k_6=120 · 4k_8=135 · 4k_10=150 · withVideo=120 · withVideo4k=180 · ⌈total⌉
Video
FIXED
20000 karakter
Kontrak request
Kirim id model di level atas. Kontrol khusus model berada di params.
| Key | Tipe | Wajib | Default | Deskripsi |
|---|---|---|---|---|
| model | string | Ya | gemini-omni-flash-1-1 | Gunakan gemini-omni-flash-1-1 sebagai id model API. |
| prompt | string | Ya | - | Maksimum 20000 karakter untuk model ini. |
| params | object | Tidak | - | Objek parameter khusus model. Gunakan baris di bawah untuk key yang diizinkan. |
| client_request_id | string | Tidak | - | ID sisi klien opsional untuk melacak request di sistem Anda. |
Parameter model
| Key | Tipe | Wajib | Default | Rentang | Opsi | Deskripsi |
|---|---|---|---|---|---|---|
| reference_mode | select | Tidak | reference | - | reference, frames | Mode referensi |
| resolution | select | Tidak | 720p | - | 360p, 720p, 1080p, 4k | Resolusi |
| duration | select | Tidak | 4 | - | 4, 6, 8, 10 | Durasi |
| aspect_ratio | select | Tidak | 16:9 | - | 16:9, 9:16 | Rasio aspek |
| seed | number | Tidak | - | min 0 / max 2147483647 | - | Biarkan kosong untuk hasil acak baru setiap kali. Menggunakan ulang integer yang sama membuat hasil sebelumnya lebih mudah direproduksi atau disempurnakan. Hasil hanya akan lebih dekat bila prompt dan pengaturan kunci lain juga tetap mirip, dan ini bukan jaminan kecocokan 1:1. |
| video_start | number | Tidak | - | min 0 / max 30 | - | Awal video (detik) |
| video_ends | number | Tidak | - | min 0 / max 30 | - | Akhir video (detik) |
Kebijakan unggahan
Unggah file referensi terlebih dahulu, lalu tempatkan URL dan duration token yang dikembalikan ke dalam params.referenceMediaItems.
Materi referensi: Gunakan hingga tujuh gambar berukuran 20 MB per gambar, atau satu video hingga 95 MB dan 30 detik dengan maksimal lima gambar. Potongan video yang dipilih tidak boleh lebih dari 10 detik. ID aset audio dan karakter tidak didukung. Mode bingkai menerima satu gambar awal atau pasangan awal/akhir, tanpa referensi lain.
7
image, video
Referensi video dan audio harus membawa durationToken dari /api/v1/files saat verifikasi durasi diperlukan.
| kind | Ukuran maksimum | Tipe MIME |
|---|---|---|
| image | 20 MB | image/jpeg, image/png, image/webp |
| video | 95 MB | video/mp4, video/quicktime |
Request minimal
{
"model": "gemini-omni-flash-1-1",
"prompt": "A cinematic product reveal with smooth camera movement",
"params": {
"reference_mode": "reference",
"resolution": "720p",
"duration": "4",
"aspect_ratio": "16:9",
"seed": 0,
"video_start": 0,
"video_ends": 0
}
}Request file referensi
{
"model": "gemini-omni-flash-1-1",
"prompt": "A cinematic product reveal with smooth camera movement",
"params": {
"reference_mode": "reference",
"resolution": "720p",
"duration": "4",
"aspect_ratio": "16:9",
"seed": 0,
"video_start": 0,
"video_ends": 0,
"referenceMediaItems": [
{
"url": "https://cdn.example.com/reference-image.png",
"kind": "image",
"name": "reference-image.png",
"mimeType": "image/png"
}
]
}
}Response create
Endpoint create mengembalikan public task id. Poll endpoint status sampai tugas berhasil atau gagal.
{
"id": "task_gemini_omni_flash_1_1_example",
"status": "queued",
"model": "gemini-omni-flash-1-1",
"reserved_credits": 45,
"final_credits": 0,
"settlement_status": "RESERVED",
"created_at": "2026-05-11T00:00:00.000Z",
"updated_at": "2026-05-11T00:00:00.000Z",
"result": null,
"error": null
}Error umum
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found
Beberapa mode membutuhkan unggahan referensi Files API.
