RouterShiftRouterShift
استعراض النماذجالأسعارالوثائق
RouterShiftRouterShiftRouterShift. بنية تحتية للذكاء الاصطناعي على مستوى المؤسسات.
استعراض النماذجالحالةالوثائقالشروطالخصوصيةاتفاقية معالجة البياناتالشفافية

وثائق واجهة برمجة التطبيقات

مرجع API

نظرة عامة على واجهة RouterShift البرمجية

يوفر RouterShift واجهات متوافقة مع OpenAI وAnthropic وGemini للنماذج النشطة لمفتاحك. يُطبق التوجيه والتحويل والفوترة ودليل التدقيق خلف حدود البروتوكول.

الميزات الرئيسية

  • واجهة برمجة تطبيقات متوافقة مع OpenAI — بديل مباشر لأي عميل OpenAI SDK
  • توجيه ذكي مع استراتيجيات قابلة للتكوين (الوزن، التوزيع الدوري، بناءً على زمن الاستجابة، التبديل الاحتياطي)
  • قاطع دائرة مدمج وتحديد معدل لحماية تطبيقك
  • تخزين مؤقت دلالي لتقليل زمن الاستجابة والتكاليف على الاستعلامات المتكررة
  • تسجيل ومراقبة وتحليلات إنفاق شاملة
  • دعم متعدد المزوّدين مع تبديل احتياطي تلقائي عند عدم توفر مزوّد

عنوان الأساس المتوافق مع OpenAI

تستخدم جميع طلبات API عنوان الأساس التالي. تتوافق الواجهة بالكامل مع مكتبات OpenAI؛ ما عليك سوى تغيير عنوان الأساس واستخدام مفتاح RouterShift API.

https://api.routershift.com/v1

عنوان الأساس المتوافق مع Anthropic

لـ Anthropic SDK أو Claude Code. ملاحظة: بدون اللاحقة /v1 — تقوم SDK بإضافة /v1/messages تلقائيًا.

https://api.routershift.com

التوافق مع بروتوكولات متعددة

تتصل عملاء OpenAI وAnthropic وGemini عادة بتغيير عنوان الأساس وبيانات الاعتماد. يحدد عقد OpenAPI الحالي الحقول والمسارات؛ امتدادات upstream ليست قابلة للنقل تلقائياً.

فئات النماذج المدعومة

يمثل GET /v1/models المرجع للنماذج المتاحة لمفتاحك. يعتمد التوفر أيضاً على المنتج وصحة المسار والصلاحيات والرصيد والمنطقة وسياسة الوصول الخاص.

الحصول على المساعدة

إذا واجهت مشاكل أو لديك أسئلة، راجع الأقسام أدناه للحصول على أدلة مفصلة. للاستفسارات المتعلقة بالفوترة، تواصل مع الدعم عبر لوحة التحكم. للحصول على تحديثات الحالة في الوقت الفعلي، قم بزيارة صفحة الحالة.

قائمة نقاط النهاية الكاملة

يمثل الجدول فهرساً مقروءاً لمستوى البيانات العام. عقد الآلة في /api/openapi.yaml والمرجع التفاعلي في /api/docs، مع استمرار نطاقات المفاتيح.

GET/v1/version

إصدار وتوافق API لمستوى البيانات

GET/v1/models

عرض النماذج

POST/v1/chat/completions

إكمال المحادثة (متوافق مع OpenAI)

POST/v1/messages

Messages API (متوافق مع Anthropic)

POST/v1/models/gemini/:model/generateContent

إنشاء محتوى Gemini

POST/v1/models/gemini/:model/streamGenerateContent

Gemini البث المباشر لتوليد المحتوى

POST/v1/embeddings

تضمينات النصوص

POST/v1/rerank

إعادة الترتيب

POST/v1/chat/completions/estimate

تقدير مسبق للرموز والتكلفة

POST/v1/images/generations

توليد الصور

POST/v1/audio/transcriptions

النسخ الصوتي

POST/v1/audio/speech

تحويل النص إلى كلام

POST/v1/tts

تحويل موسّع للنص إلى كلام

POST/v1/transcriptions

نسخ صوتي موسّع

POST/v1/midjourney/imagine

توليد الصور Midjourney

POST/v1/suno/generate

توليد الموسيقى Suno

POST/v1/video/generations

مهمة إنشاء الفيديو

GET/v1/video/tasks/:task_id

حالة مهمة إنشاء الفيديو

POST/v1/chat/completions/async

مهمة غير متزامنة — إرسال

GET/v1/chat/completions/async/:task_id

مهمة غير متزامنة — فحص الحالة

GET/v1/chat/completions/async/:task_id/result

مهمة غير متزامنة — الحصول على النتيجة

POST/v1/batch

معالجة الدفعات

GET/v1/batch/:batch_id

حالة المهمة الدفعية

GET/v1/batch/:batch_id/results

تنزيل نتائج المهمة الدفعية

POST/v1/batch/:batch_id/cancel

إلغاء المهمة الدفعية

POST/v1/mcp/

بوابة أدوات MCP JSON-RPC

GET/v1/mcp/sse

نقل MCP عبر SSE

POST/v1/a2a/

بوابة A2A JSON-RPC

GET/v1/a2a/sse

تدفق أحداث A2A عبر SSE

الطريقةالمسارالوصف
GET/v1/versionإصدار وتوافق API لمستوى البيانات
GET/v1/modelsعرض النماذج
POST/v1/chat/completionsإكمال المحادثة (متوافق مع OpenAI)
POST/v1/messages Messages API (متوافق مع Anthropic)
POST/v1/models/gemini/:model/generateContentإنشاء محتوى Gemini
POST/v1/models/gemini/:model/streamGenerateContentGemini البث المباشر لتوليد المحتوى
POST/v1/embeddingsتضمينات النصوص
POST/v1/rerankإعادة الترتيب
POST/v1/chat/completions/estimateتقدير مسبق للرموز والتكلفة
POST/v1/images/generationsتوليد الصور
POST/v1/audio/transcriptionsالنسخ الصوتي
POST/v1/audio/speechتحويل النص إلى كلام
POST/v1/ttsتحويل موسّع للنص إلى كلام
POST/v1/transcriptionsنسخ صوتي موسّع
POST/v1/midjourney/imagineتوليد الصور Midjourney
POST/v1/suno/generateتوليد الموسيقى Suno
POST/v1/video/generationsمهمة إنشاء الفيديو
GET/v1/video/tasks/:task_idحالة مهمة إنشاء الفيديو
POST/v1/chat/completions/asyncمهمة غير متزامنة — إرسال
GET/v1/chat/completions/async/:task_idمهمة غير متزامنة — فحص الحالة
GET/v1/chat/completions/async/:task_id/resultمهمة غير متزامنة — الحصول على النتيجة
POST/v1/batchمعالجة الدفعات
GET/v1/batch/:batch_idحالة المهمة الدفعية
GET/v1/batch/:batch_id/resultsتنزيل نتائج المهمة الدفعية
POST/v1/batch/:batch_id/cancelإلغاء المهمة الدفعية
POST/v1/mcp/بوابة أدوات MCP JSON-RPC
GET/v1/mcp/sseنقل MCP عبر SSE
POST/v1/a2a/بوابة A2A JSON-RPC
GET/v1/a2a/sseتدفق أحداث A2A عبر SSE

مراسلة البروتوكولات

يتوافق RouterShift مع عدة بروتوكولات API. يوضح الجدول أدناه عنوان الأساس وتكوين SDK لكل بروتوكول.

متوافق مع OpenAI

https://api.routershift.com/v1

Models: <available-model-code>

Authorization: Bearer / x-api-key

متوافق مع Anthropic

https://api.routershift.com

Models: <available-model-code>

x-api-key: sk-xxx

Gemini الأصلي

https://api.routershift.com/v1

Models: <available-model-code>

Authorization: Bearer

عنوان الأساسمثال معامِل النموذجرأس المصادقة
https://api.routershift.com/v1
OpenAI SDK القياسي — فقط غيّر base_url
<available-model-code>Authorization: Bearer / x-api-key
https://api.routershift.com
Anthropic SDK القياسي — فقط غيّر base_url
<available-model-code>x-api-key: sk-xxx
https://api.routershift.com/v1
تنسيق Gemini الأصلي، استدعِ generateContent مباشرة
<available-model-code>Authorization: Bearer

مصادقة موحدة

تستخدم جميع نقاط النهاية نفس المصادقة. كلا تنسيقي الرأس يعملان بشكل مطابق:

تنسيق متوافق مع OpenAI

Authorization: Bearer sk-xxx

تنسيق متوافق مع Anthropic

x-api-key: sk-xxx