الانتقال إلى المحتوى الرئيسي
واجهة /v1beta/ في OrcaRouter هي تمرير مباشر إلى واجهة Gemini API من Google. اختر هذا المسار عندما تريد ميزات Gemini التي لا تتناسب مع شكل OpenAI — مثل بيانات الصوت/الفيديو المضمّنة، أو الأدوات المدمجة الأصلية مثل googleSearch، أو generationConfig.thinkingConfig الكامل التكوين، أو ببساطة لأنك تستخدم بالفعل google-genai SDK. للمحادثة اليومية، يكون المسار المتوافق مع OpenAI (POST /v1/chat/completions مع model=google/...) عادةً أبسط ويعمل عبر المزودين المختلفين — راجع التوافق / Google GenAI SDK لإعداد SDK.

​
تخطيط المسار

POST https://api.orcarouter.ai/v1beta/models/{model}:{action}
الإجراءات المعروفة:
الإجراءما الذي يفعله
:generateContentاستجابة واحدة (JSON)
:streamGenerateContentبث SSE من الأجزاء الجزئية
إجراءات Gemini الأخرى (countTokens، tunedModels.*، إلخ) غير مُوجَّهة عبر هذه الواجهة حاليًا.

​
المصادقة

تقبل البوابة ثلاثة أشكال من الترويسة على هذه الواجهة، بحيث يعمل google-genai SDK الرسمي دون الحاجة إلى تعديلات على الترويسات:
  • Authorization: Bearer sk-orca-...
  • x-goog-api-key: sk-orca-...
  • ?key=sk-orca-... (سلسلة الاستعلام، حل أخير للأدوات التي لا تدعم تعيين الترويسات)

​
أمثلة

curl "https://api.orcarouter.ai/v1beta/models/google/gemini-2.5-flash:generateContent" \
  -H "Authorization: Bearer sk-orca-..." \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role": "user", "parts": [{"text": "Write a one-sentence haiku about the sea."}]}]
  }'

​
الأدوات المدمجة

تعمل أدوات Gemini الثلاث المدمجة الأصلية كما هو موثّق من Google — مرّرها في مصفوفة tools ضمن جسم الطلب:
الأداةالتأثير
{"googleSearch": {}}تأسيس الويب. تحمل الاستجابة groundingMetadata. يلتقط OrcaRouter webSearchQueries لأغراض الفوترة.
{"codeExecution": {}}تتيح للنموذج تشغيل Python في بيئة معزولة.
{"urlContext": {}}تتيح للنموذج جلب وتلخيص الروابط التي تذكرها.
الأدوات الثلاث نفسها متاحة من Chat Completions بشكل OpenAI عبر أسماء دوال محجوزة — راجع متقدم / البحث على الويب و متقدم / استدعاء الأدوات.

​
انظر أيضًا