curl --request POST \
  --url https://api.orcarouter.ai/v1beta/models/{model_path} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Write a one-sentence haiku about the sea."
        }
      ]
    }
  ]
}
'

{}

Gemini Native

التوليد الأصلي عبر Gemini

تمرير مباشر إلى واجهة Gemini من Google. المعامل model_path هو <model>:<action>، مثلًا google/gemini-2.5-flash:generateContent أو google/gemini-2.5-flash:streamGenerateContent.

الإجراءات المدعومة:

الإجراء	ما يفعله
`:generateContent`	استجابة واحدة (JSON)
`:streamGenerateContent`	بث SSE لأجزاء جزئية

ما يمكنك فعله على هذه الواجهة (يبقى شكل الطلب هو شكل JSON الأصلي لـ Gemini؛ اختر النموذج المناسب لكل حالة):

المحادثة / الاستدلال — أي نموذج محادثة gemini-*، مقترنًا بـ generationConfig.thinkingConfig للتحكم في الميزانية.
إدخال متعدد الوسائط — أجزاء inline_data لمحتوى الصور / الصوت / الفيديو / الملفات إلى جانب أجزاء text.
استدعاء الدوال — tools: [{functionDeclarations: [...]}].
أدوات الخادم المدمجة — tools: [{googleSearch: {}}]، tools: [{codeExecution: {}}]، tools: [{urlContext: {}}].
تحويل النص إلى كلام — نماذج *-tts التجريبية مع generationConfig.responseModalities: ["AUDIO"] و speechConfig.voiceConfig.
توليد الصور — نماذج gemini-*-image*؛ تحمل الاستجابة الصورة كجزء inlineData.

تقبل المصادقة الترويسة القياسية Authorization: Bearer sk-orca-…، بالإضافة إلى ترويسة x-goog-api-key على طراز Gemini وسلسلة الاستعلام ?key= لتوافق google-genai SDK — انظر الحصول على مفتاح API.

POST

v1beta

models

{model_path}

curl --request POST \
  --url https://api.orcarouter.ai/v1beta/models/{model_path} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Write a one-sentence haiku about the sea."
        }
      ]
    }
  ]
}
'

{}

التفويضات

Authorization

string

header

مطلوب

تبدو مفاتيح OrcaRouter API على شكل sk-orca-.... مرّرها في ترويسة Authorization: Bearer sk-orca-....

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

model_path

string

مطلوب

الجسم

application/json

جسم طلب Gemini الأصلي (شكل GenerateContentRequest من Google). انظر الأمثلة للحمولات الشائعة.

الاستجابة

استجابة ناجحة. لـ :generateContent يكون الجسم JSON (GenerateContentResponse). لـ :streamGenerateContent يكون الجسم SSE (text/event-stream)؛ كل حدث هو GenerateContentResponse جزئي.

استجابة Gemini الأصلية GenerateContentResponse.

إنشاء رسالة