الانتقال إلى المحتوى الرئيسي
يوجد مساران للبحث على الويب من خلال OrcaRouter:
  1. نماذج search-preview — استدعِ متغيّر بحث مباشرةً عبر /v1/chat/completions
  2. الأدوات / الخيارات على نموذج عادي — مرّر web_search_options (Chat) أو tools: [{"type": "web_search"}] (Responses)

​
نماذج search-preview (OpenAI)

تنشر OpenAI متغيّرات search-preview لعدة نماذج — على سبيل المثال openai/gpt-4o-search-preview و openai/gpt-5-search-api. اختر أحدها كـ model على /v1/chat/completions وسيتولى المصدر الأعلى عملية البحث من جهة الخادم. استدعِ /v1/models للحصول على الفهرس المباشر.

​
web_search_options (Chat Completions)

curl https://api.orcarouter.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-orca-..." \
  -d '{
    "model": "openai/gpt-4o-search-preview",
    "messages": [{"role": "user", "content": "What changed in OpenAI pricing this week?"}],
    "web_search_options": {"search_context_size": "medium"}
  }'
search_context_size: low / medium / high. يتحكم في عمق البحث (سعر الاستدعاء لـ web_search متماثل بغض النظر عن الحجم).

​
الأدوات (Responses API)

يقبل /v1/responses المعطى tools: [{"type": "web_search"}] على كلّ من نماذج OpenAI وأي نموذج Grok — فواجهة Agent Tools من xAI تعيش على نفس نقطة النهاية. 
# OpenAI
curl https://api.orcarouter.ai/v1/responses \
  -H "Authorization: Bearer sk-orca-..." \
  -d '{
    "model": "openai/gpt-5",
    "input": "What changed in OpenAI pricing this week?",
    "tools": [{"type": "web_search"}]
  }'

# Grok (xAI Agent Tools)
curl https://api.orcarouter.ai/v1/responses \
  -H "Authorization: Bearer sk-orca-..." \
  -d '{
    "model": "grok/grok-4-fast-reasoning",
    "input": "What changed in xAI pricing this week?",
    "tools": [{"type": "web_search"}]
  }'
كل web_search_call يُصدره المصدر الأعلى يُحتسب للفوترة — راجع العمليات / الفوترة والاستخدام.

​
الدعم عبر المزوّدين

يصل البحث على الويب إلى كل مزوّد يكشف عنه؛ ما يختلف هو نقطة الدخول فقط:
المزوّدالبحث على الويبالطريقة
OpenAI✅نماذج search-preview، أو تمرير أداة web_search إلى /v1/responses
xAI Grok✅استدعِ /v1/responses مع tools: [{"type": "web_search"}] وأي نموذج Grok — واجهة Agent Tools من xAI. (أوقفت xAI search_parameters القديم على chat completions في 2026-01-12؛ ولم تعد متغيّرات أسماء نماذج *-search القديمة تعمل.)
Anthropic✅مرّر web_search_options على طلب Chat Completions — يُترجم إلى أداة الخادم الأصلية web_search في Anthropic. يُربط search_context_size (low/medium/high) بـ max_uses؛ ويُربط user_location.approximate بـ user_location في Anthropic.
Gemini✅مرّر أداة دالة باسم googleSearch (انظر أدناه) — تُترجم إلى أداة التأريض الأصلية GoogleSearch في Gemini.
DeepSeek❌لا تكشف واجهة DeepSeek عن البحث على الويب.

​
تأريض Gemini عبر googleSearch

بالنسبة لنماذج Gemini، تتعرف طبقة الترجمة في OrcaRouter على اسم دالة سحري هو googleSearch وتحوّله إلى أداة التأريض الأصلية GoogleSearch في Gemini. أرسله مثل أي أداة دالة بأسلوب OpenAI: 
curl https://api.orcarouter.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-orca-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-2.5-flash",
    "messages": [{"role":"user","content":"What changed in Gemini pricing this week?"}],
    "tools": [{"type":"function","function":{"name":"googleSearch"}}]
  }'
تلتقط البوابة بيانات التأريض التي تعيدها Gemini (webSearchQueries، إلخ) للفوترة وتعرضها عبر الحقول القياسية لاستجابة chat-completion. يُتعرَّف على اسمي دالتين سحريتين متعلقتين على نفس مسار الشيفرة:
  • codeExecution — يفعّل أداة تنفيذ التعليمات البرمجية الأصلية في Gemini
  • urlContext — يفعّل أداة سياق الـ URL في Gemini

​
أو استخدم المسار الأصلي

إذا كنت تستخدم بروتوكول Gemini الأصلي عبر /v1beta/، مرّر googleSearch مباشرةً بشكل Gemini — دون الحاجة إلى ترجمة الاسم السحري: 
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":"What changed in Gemini pricing this week?"}]}],
    "tools": [{"googleSearch": {}}]
  }'
تعمل {"codeExecution": {}} و {"urlContext": {}} بنفس الطريقة على المسار الأصلي. راجع التنسيقات الأصلية / Gemini.

​
الفوترة

يتم تتبع web_search و web_search_preview كاستدعاءات أدوات مدمجة. ولهما شرائح تسعير مختلفة — راجع العمليات / الفوترة والاستخدام لمعرفة التفاصيل.