Skip to main content
يعرض TokenLab هذا المسار فقط للنماذج التي تعلن عقد Gemini الأصلي ولها قناة upstream من البروتوكول نفسه؛ ولا يعود الطلب إلى Chat Completions. أسماء ProtoJSON بصيغة lowerCamelCase وأسماء proto الأصلية بصيغة snake_case رسمية معًا، وتُحفظ بما في ذلك الطلبات المختلطة. تُمرر الحقول غير المعروفة بأفضل جهد ويقرر upstream دعمها.

معلمات المسار

string
مطلوب
اسم النموذج (على سبيل المثال، gemini-2.5-pro، gemini-3.5-flash).

معلمات الاستعلام

string
مفتاح API (بديل للمصادقة عبر الترويسة).

المصادقة

تدعم نقاط نهاية Gemini طرق مصادقة متعددة:
  • ?key=YOUR_API_KEY معلمة استعلام
  • x-goog-api-key: YOUR_API_KEY ترويسة
  • Authorization: Bearer YOUR_API_KEY ترويسة

جسم الطلب

array
مطلوب
محتوى المحادثة. تُحفظ قيم role وكل parts كما أرسلها العميل من دون trim أو lowercase أو إعادة ترميز Base64 أو استنتاج MIME. الصيغتان inlineData / inline_data وfileData / file_data رسميتان؛ ولا تشترط TokenLab محليًا fileData.mimeType. عند الإشارة إلى Files أو Cache أنشأتها TokenLab، يُفحص المالك ويُربط مع upstream الأصلي، وتُترك صلاحية باقي الوسائط والأدوات للمزوّد.
object
تعليمات النظام للنموذج.
object
إعدادات الإنشاء الأصلية. يُقبل كل من أسماء lowerCamelCase مثل maxOutputTokens وcandidateCount وthinkingConfig وأسماء snake_case المناظرة كما هو. لا تزيل TokenLab thinkingConfig بعد الفشل ولا تفرض حدًا محليًا لـ candidateCount في البث؛ ويقرر upstream النطاقات والتركيبات المدعومة.
array
إعدادات فلاتر الأمان.

الاستجابة

array
مرشحو المحتوى الذي تم إنشاؤه.
object
معلومات استخدام الـ token.

أمثلة الإدخال متعدد الوسائط

في طلبات Gemini متعددة الوسائط، ضع الوسائط داخل contents[].parts[] باستخدام بايتات مضمّنة أو مراجع ملفات عبر URL. فئات الوسائط المدعومة حالياً في تفاصيل النموذج لـ Gemini:
  • صورة
  • صوت
  • فيديو
بالنسبة إلى الوسائط المضمّنة، استخدم inlineData أو inline_data ومرّر بايتات الملف بترميز Base64. بالنسبة إلى الوسائط عبر URL، استخدم fileData أو file_data ومرّر عنوان https عاماً يمكن الوصول إليه.

مثال إدخال صورة

مثال إدخال صوت

مثال إدخال فيديو

مثال إدخال الفيديو

مثال إدخال الصوت