دمج API لنموذج Gemini Omni 1.1 Flash
استخدم Gemini Omni 1.1 Flash عبر Rivya Public API v1 مع معرف النموذج gemini-omni-flash-1-1، والمدخلات المدعومة، والمعلمات، وقواعد Files API، والأرصدة، وأمثلة الاستجابة.
gemini-omni-flash-1-1
text, file
مطلوب لأوضاع المراجع
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⌉
فيديو
FIXED
20000 أحرف
عقد الطلب
أرسل معرف النموذج في المستوى الأعلى. توضع عناصر التحكم الخاصة بالنموذج داخل params.
| المفتاح | النوع | مطلوب | الافتراضي | الوصف |
|---|---|---|---|---|
| model | string | نعم | gemini-omni-flash-1-1 | استخدم معرف نموذج API وهو gemini-omni-flash-1-1. |
| prompt | string | نعم | - | الحد الأقصى لهذا النموذج هو 20000 حرفًا. |
| params | object | لا | - | كائن معلمات خاص بالنموذج. استخدم الصفوف أدناه لمعرفة المفاتيح المسموح بها. |
| client_request_id | string | لا | - | معرف اختياري من جهة العميل لتتبع الطلبات في نظامك. |
معلمات النموذج
| المفتاح | النوع | مطلوب | الافتراضي | النطاق | الخيارات | الوصف |
|---|---|---|---|---|---|---|
| reference_mode | select | لا | reference | - | reference, frames | وضع المرجع |
| resolution | select | لا | 720p | - | 360p, 720p, 1080p, 4k | الدقة |
| duration | select | لا | 4 | - | 4, 6, 8, 10 | المدة |
| aspect_ratio | select | لا | 16:9 | - | 16:9, 9:16 | نسبة العرض إلى الارتفاع |
| seed | number | لا | - | min 0 / max 2147483647 | - | اتركه فارغا للحصول على نتيجة عشوائية جديدة في كل مرة. إعادة استخدام العدد الصحيح نفسه تسهّل إعادة إنتاج نتيجة سابقة أو ضبطها. تكون النتيجة أقرب فقط عندما يبقى الموجّه والإعدادات الرئيسية الأخرى متشابهة أيضا، ولا يضمن ذلك تطابقا 1:1. |
| video_start | number | لا | - | min 0 / max 30 | - | بداية الفيديو (ثوانٍ) |
| video_ends | number | لا | - | min 0 / max 30 | - | نهاية الفيديو (ثوانٍ) |
سياسة الرفع
ارفع ملفات المراجع أولا، ثم ضع URL وduration token اللذين تم إرجاعهما داخل params.referenceMediaItems.
مواد مرجعية: استخدم حتى سبع صور بحجم 20 MB لكل صورة، أو فيديو واحد حتى 95 MB و30 ثانية مع خمس صور كحد أقصى. يجب ألا يتجاوز المقطع المختار 10 ثوانٍ. معرّفات الصوت والشخصيات غير مدعومة. يقبل وضع الإطارات صورة بداية أو صورتَي بداية ونهاية، دون مراجع أخرى.
7
image, video
ينبغي أن تحمل مراجع الفيديو والصوت durationToken من /api/v1/files عندما يكون التحقق من المدة مطلوبا.
| kind | الحد الأقصى للحجم | أنواع MIME |
|---|---|---|
| image | 20 MB | image/jpeg, image/png, image/webp |
| video | 95 MB | video/mp4, video/quicktime |
الطلب الأدنى
{
"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
}
}طلب بملف مرجعي
{
"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"
}
]
}
}استجابة الإنشاء
تعيد نقطة نهاية الإنشاء معرف مهمة عامًا. استعلم عن نقطة نهاية الحالة حتى تنجح المهمة أو تفشل.
{
"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
}الأخطاء الشائعة
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found
تتطلب بعض الأوضاع رفع مراجع عبر Files API.
