Gemini Omni 1.1 Flash API Entegrasyonu
Gemini Omni 1.1 Flash modelini Rivya Public API v1 üzerinden model id gemini-omni-flash-1-1, desteklenen girişler, parametreler, Files API kuralları, krediler ve yanıt örnekleriyle kullanın.
gemini-omni-flash-1-1
text, file
Referans modları için gerekli
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
İstek sözleşmesi
Model id değerini en üst seviyede gönderin. Modele özel kontroller params içine aittir.
| Anahtar | Tür | Gerekli | Varsayılan | Açıklama |
|---|---|---|---|---|
| model | string | Evet | gemini-omni-flash-1-1 | gemini-omni-flash-1-1 API model kimliği değerini kullanın. |
| prompt | string | Evet | - | Bu model için en fazla 20000 karakter. |
| params | object | Hayır | - | Modele özel parametre nesnesi. İzin verilen anahtarlar için aşağıdaki satırları kullanın. |
| client_request_id | string | Hayır | - | Sisteminizde istekleri izlemek için isteğe bağlı istemci tarafı id. |
Model parametreleri
| Anahtar | Tür | Gerekli | Varsayılan | Aralık | Seçenekler | Açıklama |
|---|---|---|---|---|---|---|
| reference_mode | select | Hayır | reference | - | reference, frames | Referans modu |
| resolution | select | Hayır | 720p | - | 360p, 720p, 1080p, 4k | Çözünürlük |
| duration | select | Hayır | 4 | - | 4, 6, 8, 10 | Süre |
| aspect_ratio | select | Hayır | 16:9 | - | 16:9, 9:16 | En-boy oranı |
| seed | number | Hayır | - | min 0 / max 2147483647 | - | Her seferinde yeni bir rastgele sonuç için boş bırakın. Aynı tam sayıyı yeniden kullanmak, önceki bir sonucu yeniden üretmeyi veya ince ayar yapmayı kolaylaştırır. Yalnızca istem ve diğer temel ayarlar da benzer kaldığında sonuca daha yakın durur; bire bir eşleşme garanti değildir. |
| video_start | number | Hayır | - | min 0 / max 30 | - | Video başlangıcı (saniye) |
| video_ends | number | Hayır | - | min 0 / max 30 | - | Video sonu (saniye) |
Yükleme politikası
Önce referans dosyalarını yükleyin, ardından dönen URLyi ve duration token değerini params.referenceMediaItems içine yerleştirin.
Referans materyalleri: Her biri 20 MB olan en fazla yedi görsel ya da en fazla beş görselle birlikte 95 MB ve 30 saniyeyi aşmayan tek video kullanın. Seçilen video bölümü 10 saniyeyi geçemez. Ses ve karakter varlık ID’leri desteklenmez. Kare modu, başka referans olmadan bir başlangıç görseli veya başlangıç/bitiş çifti kabul eder.
7
image, video
Süre doğrulaması gerektiğinde video ve ses referansları /api/v1/files içinden durationToken taşımalıdır.
| kind | Maks. boyut | MIME türleri |
|---|---|---|
| image | 20 MB | image/jpeg, image/png, image/webp |
| video | 95 MB | video/mp4, video/quicktime |
Minimal istek
{
"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
}
}Referans dosyalı istek
{
"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"
}
]
}
}Create yanıtı
Create endpointi herkese açık task id döndürür. Görev başarılı veya başarısız olana kadar status endpointini sorgulayın.
{
"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
}Yaygın hatalar
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found
Bazı modlar Files API referans yüklemeleri gerektirir.
