وثائق Rivya AI
صفحات API للنماذج

دمج API لنموذج Gemini Omni 1.1 Flash

استخدم Gemini Omni 1.1 Flash عبر Rivya Public API v1 مع معرف النموذج gemini-omni-flash-1-1، والمدخلات المدعومة، والمعلمات، وقواعد Files API، والأرصدة، وأمثلة الاستجابة.

متاح عبر APIالنص أو URL جاهز؛ تستخدم أوضاع المراجع Files APIفيديو
معرف نموذج API

gemini-omni-flash-1-1

المدخلات

text, file

Files API

مطلوب لأوضاع المراجع

الأرصدة الأساسية

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

حد prompt

20000 أحرف

عقد الطلب

أرسل معرف النموذج في المستوى الأعلى. توضع عناصر التحكم الخاصة بالنموذج داخل params.

المفتاحالنوعمطلوبالافتراضيالوصف
modelstringنعمgemini-omni-flash-1-1استخدم معرف نموذج API وهو gemini-omni-flash-1-1.
promptstringنعم-الحد الأقصى لهذا النموذج هو 20000 حرفًا.
paramsobjectلا-كائن معلمات خاص بالنموذج. استخدم الصفوف أدناه لمعرفة المفاتيح المسموح بها.
client_request_idstringلا-معرف اختياري من جهة العميل لتتبع الطلبات في نظامك.

معلمات النموذج

المفتاحالنوعمطلوبالافتراضيالنطاقالخياراتالوصف
reference_modeselectلاreference-reference, framesوضع المرجع
resolutionselectلا720p-360p, 720p, 1080p, 4kالدقة
durationselectلا4-4, 6, 8, 10المدة
aspect_ratioselectلا16:9-16:9, 9:16نسبة العرض إلى الارتفاع
seednumberلا-min 0 / max 2147483647-اتركه فارغا للحصول على نتيجة عشوائية جديدة في كل مرة. إعادة استخدام العدد الصحيح نفسه تسهّل إعادة إنتاج نتيجة سابقة أو ضبطها. تكون النتيجة أقرب فقط عندما يبقى الموجّه والإعدادات الرئيسية الأخرى متشابهة أيضا، ولا يضمن ذلك تطابقا 1:1.
video_startnumberلا-min 0 / max 30-بداية الفيديو (ثوانٍ)
video_endsnumberلا-min 0 / max 30-نهاية الفيديو (ثوانٍ)

سياسة الرفع

ارفع ملفات المراجع أولا، ثم ضع URL وduration token اللذين تم إرجاعهما داخل params.referenceMediaItems.

قاعدة المرجع

مواد مرجعية: استخدم حتى سبع صور بحجم 20 MB لكل صورة، أو فيديو واحد حتى 95 MB و30 ثانية مع خمس صور كحد أقصى. يجب ألا يتجاوز المقطع المختار 10 ثوانٍ. معرّفات الصوت والشخصيات غير مدعومة. يقبل وضع الإطارات صورة بداية أو صورتَي بداية ونهاية، دون مراجع أخرى.

الحد الأقصى للملفات

7

أنواع الملفات المقبولة

image, video

Duration token

ينبغي أن تحمل مراجع الفيديو والصوت durationToken من /api/v1/files عندما يكون التحقق من المدة مطلوبا.

kindالحد الأقصى للحجمأنواع MIME
image20 MBimage/jpeg, image/png, image/webp
video95 MBvideo/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.