الانتقال إلى المحتوى الرئيسي
POST
/
chat
/
completions
curl --request POST \
  --url https://api.orcarouter.ai/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "openai/gpt-4o-mini",
  "messages": [
    {
      "role": "user",
      "content": "Say hi in one word."
    }
  ],
  "max_tokens": 10
}
'
{
  "id": "<string>",
  "created": 123,
  "model": "<string>",
  "choices": [
    {
      "index": 123,
      "message": {
        "content": "<string>",
        "name": "<string>",
        "tool_calls": [
          {
            "id": "<string>",
            "function": {
              "name": "<string>",
              "arguments": "<string>"
            }
          }
        ],
        "tool_call_id": "<string>"
      }
    }
  ],
  "usage": {
    "prompt_tokens": 123,
    "completion_tokens": 123,
    "total_tokens": 123
  }
}

التفويضات

​
Authorization
string
header
مطلوب

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

الجسم

application/json
​
model
string
مطلوب

معرّف النموذج. يدعم ثلاثة أشكال:

  • مسبوق بالمزوّد (الافتراضي): openai/gpt-4o-mini، anthropic/claude-sonnet-4.6، google/gemini-2.5-flash
  • اسم مستعار بسيط: gpt-4o-mini (عند توفّر اسم مستعار مختصر)
  • موجِّه مسمّى: orcarouter/{name} (يُحلّ إلى نموذج وقت الطلب؛ يتم تعيين orcarouter/auto تلقائيًا عند التسجيل لكل حساب ويختار أرخص نموذج محادثة حيّ)
أمثلة:

"gpt-4o"

"openai/gpt-4o"

"orcarouter/auto"

​
messages
object[]
مطلوب
​
stream
boolean

عندما تكون true، تُبثّ الاستجابة كأحداث مرسَلة من الخادم.

​
stream_options
object

تنطبق فقط عندما يكون stream: true.

​
tools
object[]
​
tool_choice
الخيارات المتاحة:
auto,
none,
required
​
parallel_tool_calls
boolean
افتراضي:true
​
response_format
Text (default) · object
​
temperature
number
النطاق المطلوب: 0 <= x <= 2
​
top_p
number
النطاق المطلوب: 0 <= x <= 1
​
max_tokens
integer
النطاق المطلوب: x >= 1
​
max_completion_tokens
integer

يُفضَّل على max_tokens لنماذج الاستدلال.

​
n
integer
افتراضي:1
النطاق المطلوب: x >= 1
​
stop
​
seed
integer

لأخذ عيّنات حتمي.

​
logprobs
boolean
​
top_logprobs
integer
النطاق المطلوب: 0 <= x <= 20
​
presence_penalty
number
النطاق المطلوب: -2 <= x <= 2
​
frequency_penalty
number
النطاق المطلوب: -2 <= x <= 2
​
logit_bias
object
​
user
string
​
reasoning_effort
enum<string>

لنماذج الاستدلال من OpenAI (o1، o3*، o4*، gpt-5*-pro، وما إلى ذلك). يستخدم Anthropic Claude حقل thinking بدلًا من ذلك؛ ويستخدم Gemini تكوينًا خاصًا بالمزوّد.

الخيارات المتاحة:
low,
medium,
high
​
web_search_options
object

تفعيل البحث على الويب في طلب Chat Completions. تستخدم واجهة Responses API بدلًا من ذلك tools: [{"type": "web_search"}]. تكرّم هذا نماذج OpenAI الخاصة بمعاينة البحث، ونماذج OpenAI التي تقبل أداة web_search الحديثة، ونماذج Anthropic (تُترجم إلى أداة الخادم الأصلية web_search لـ Anthropic).

​
web_search
any

حمولة خام بأي شكل تُمرَّر إلى أداة البحث على الويب الخاصة بالمزوّد الأصلي عندما لا يكون web_search_options معبِّرًا بما يكفي. يجب على معظم المستخدمين تفضيل web_search_options.

​
extra_body
object

توسعات الطلب الخاصة بـ OrcaRouter. ضع هذه ضمن المفتاح الأعلى extra_body في طلب إكمال المحادثة.

الاستجابة

إكمال ناجح. تستخدم استجابات البث SSE (text/event-stream).

​
id
string
​
object
enum<string>
الخيارات المتاحة:
chat.completion
​
created
integer
​
model
string
​
choices
object[]
​
usage
object