معلمات المسار
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 عاماً يمكن الوصول إليه.