الانتقال إلى المحتوى الرئيسي
يوفّر OrcaRouter واجهة من الدرجة الأولى متوافقة مع OpenAI. وجّه OpenAI SDK الحالي لديك إلى عنوان URL الأساسي الخاص بـ OrcaRouter وسيستمر الكود في العمل بالطريقة التي يتوقعها الـ SDK — البث، واستدعاء الأدوات، والمخرجات المنظمة (json_object و json_schema)، والرؤية كلها مدعومة. وعندما تستهدف نموذجًا من مزوّد مختلف، تتولى طبقة الترجمة في OrcaRouter تكييف الطلب والاستجابة وفق الشكل الأصلي لذلك المزوّد، بحيث يبقى كود الـ SDK لديك دون تغيير.

​
Python

from openai import OpenAI

client = OpenAI(
    base_url="https://api.orcarouter.ai/v1",
    api_key="sk-orca-...",
)

​
TypeScript / Node

import OpenAI from "openai";

const openai = new OpenAI({
  baseURL: "https://api.orcarouter.ai/v1",
  apiKey: "sk-orca-...",
});

​
Python غير المتزامن (Async)

from openai import AsyncOpenAI

client = AsyncOpenAI(
    base_url="https://api.orcarouter.ai/v1",
    api_key="sk-orca-...",
)

​
استخدام متغيرات البيئة

يقرأ OpenAI SDK متغيري OPENAI_API_KEY و OPENAI_BASE_URL افتراضيًا. عيّنهما مرة واحدة وسيلتقطهما الـ SDK دون الحاجة إلى إعداد لكل استدعاء: 
export OPENAI_API_KEY="sk-orca-..."
export OPENAI_BASE_URL="https://api.orcarouter.ai/v1"

​
ما الذي يتغيّر في كودك

فقط عنوان URL الأساسي ومفتاح الـ API. أما معاملات الطلب، وشكل الاستجابة، وبروتوكول البث، ومعالجة الأخطاء — فكلها تبقى دون تغيير. أسماء النماذج مسبوقة باسم المزوّد (openai/gpt-4o-mini، anthropic/claude-sonnet-4.6، google/gemini-2.5-pro، deepseek/deepseek-chat، grok/grok-4-fast-reasoning، qwen/qwen3.6-plus، kimi/kimi-k2.6، minimax/minimax-m2.7) حتى يعرف العملاء دائمًا أي مزوّد خدم الطلب؛ ويتولى OrcaRouter الترجمة بين المزوّدين داخليًا عبر نفس كائن العميل.

​
هل ترغب في إضافة web_search؟

يعمل البحث على الويب مع OpenAI SDK عبر OrcaRouter. راجع متقدم / البحث على الويب للاطلاع على أشكال المعاملات لكل نقطة نهاية والنماذج التي تدعمها.

​
SDKs أخرى

هل تستخدم Anthropic SDK أو google-genai SDK مباشرة؟ راجع التوافق / Anthropic SDK و التوافق / Google GenAI SDK.