OmniRoute / سطح API

نقطة نهاية واحدة، أكثر من المحادثة.

المحادثة والتضمينات وإعادة الترتيب والصور والفيديو والموسيقى والكلام وOCR والملفات والدُفعات، بتنسيق الطلب الذي يتحدثه عميلك بالفعل.

اطّلع على التنسيقات جرّب Cheaper Inference العودة إلى النظرة العامة

تنسيقات الشبكة

احتفظ بشكل الطلب الذي يرسله عميلك بالفعل.

عملية واحدة تقبل عدة تنسيقات، فالأداة المبنية على SDK مورد واحد لا تحتاج سوى تغيير العنوان الأساسي.

OpenAI

Chat Completions والتضمينات والصور والصوت والملفات، دون تغيير.

/v1/chat/completions

Anthropic

تنسيق Messages على الشبكة، بما في ذلك عدّ الرموز.

/v1/messages

OpenAI Responses

شكل Responses API، مع ضغط مخرجات الأدوات.

/v1/responses

Gemini

generateContent وقائمة نماذج Gemini.

/v1beta/models

Ollama

بديل مباشر للأدوات التي تتحدث Ollama API المحلية.

/v1/api/chat

Rerank and Jina

إعادة ترتيب Cohere/Voyage إضافة إلى تصنيف وتقسيم Jina.

/v1/rerank

نقاط النهاية

أكثر من إكمال المحادثات.

مجمّعة حسب ما تحاول فعله لا حسب المزود الذي يخدمه بالمصادفة.

المحادثة والرسائل

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

POST/v1/chat/completionsOpenAI Chat Completions، بثًا أو مخزّنًا
POST/v1/messagesAnthropic Messages
POST/v1/responsesOpenAI Responses
POST/v1/messages/count_tokensعدّ الرموز قبل إنفاقها

التضمينات والبحث والترتيب

نصف الاسترجاع من حزمة RAG خلف نقطة النهاية نفسها والمفتاح نفسه.

POST/v1/embeddingsتضمينات نصية ومتعددة الوسائط
POST/v1/rerankإعادة ترتيب متوافقة مع Cohere وVoyage
POST/v1/searchتجريد للبحث في الويب عبر المزودين
POST/v1/classifyتصنيف النصوص من Jina
POST/v1/segmentتقسيم المحتوى من Jina
POST/v1/web/fetchاستخراج الصفحات بصيغة قابلة للقراءة

الصور والفيديو والموسيقى

يمر التوليد عبر نفس التبديل الاحتياطي ومحاسبة التكلفة كما في النص.

POST/v1/images/generationsتوليد الصور
POST/v1/images/editsالتحرير والرسم الداخلي
POST/v1/videos/generationsتوليد الفيديو
POST/v1/music/generationsتوليد الموسيقى

الصوت والمستندات

الكلام في الاتجاهين، إضافة إلى OCR للمواد المصدرية الممسوحة ضوئيًا.

POST/v1/audio/transcriptionsتحويل الكلام إلى نص
POST/v1/audio/translationsنسخ مع ترجمة
POST/v1/audio/speechتحويل النص إلى كلام
POST/v1/ocrOCR للمستندات

الملفات والدُفعات

ارفع مرة واحدة، ثم نفّذ العمل بشكل غير متزامن بدلًا من إبقاء الاتصال مفتوحًا.

POST/v1/filesرفع ملف
GET/v1/files/{id}/contentبث محتوى الملف مرة أخرى
POST/v1/batchesإنشاء مهمة دُفعية
GET/v1/batches/{id}استطلاع حالة الدُفعة
POST/v1/batches/{id}/cancelإلغاء دُفعة قيد التشغيل

الاكتشاف والتحكم

كل ما يحتاجه العميل لاختيار نموذج والبقاء ضمن الميزانية.

GET/v1/modelsكتالوج النماذج مجمّعًا حسب المزود
GET/v1/quotas/checkالتحقق المسبق من الحصة المتبقية
POST/v1/moderationsالإشراف على المحتوى
GET/v1/wsترقية WebSocket لعملاء البث

بروتوكولات الوكلاء

خادم MCP بـ 110 أداة وبطاقة وكيل A2A، تقدمهما العملية نفسها.

GET/api/mcp/streamMCP عبر HTTP، 33 نطاقات
GET/api/mcp/sseMCP عبر Server-Sent Events
POST/a2aJSON-RPC 2.0، 6 مهارة وكيل
GET/.well-known/agent.jsonبطاقة وكيل عامة

الترويسات

كل استجابة تخبرك كيف خُدمت.

التوجيه ليس صندوقًا أسود: القرار والتكلفة والضغط الذي أنتج الاستجابة تعود كلها معها.

ترويسات الاستجابة

X-OmniRoute-Decisionالاستراتيجية واسم المزود المستعار وزمن الاستجابة الذي خدم الطلب
X-OmniRoute-Providerاسم المزود المستعار الذي وُجّه إليه فعليًا
X-OmniRoute-Modelمعرّف النموذج الذي تم حله
X-OmniRoute-Latency-Msزمن استجابة المصدر بالمللي ثانية
X-OmniRoute-Tokens-Inعدد رموز الإدخال
X-OmniRoute-Tokens-Outعدد رموز الإخراج
X-OmniRoute-Response-Costتكلفة هذه الاستجابة بالدولار
X-OmniRoute-Cost-Savedالدولارات الموفّرة عند إصابة ذاكرة التخزين
X-OmniRoute-CacheHIT أو MISS في الطلبات غير المبثوثة
X-OmniRoute-Compressionوضع الضغط المطبّق ومصدره
X-OmniRoute-Fallback-Attemptsقفزات التبديل الاحتياطي المتخذة، إن وُجدت
X-OmniRoute-Request-Idمعرّف الارتباط لسجل الطلبات

ترويسات الطلب

x-omniroute-compressionتجاوز ملف الضغط لطلب واحد
X-OmniRoute-No-Cacheتجاوز ذاكرة التخزين الدلالية
x-omniroute-no-memoryتخطي حقن الذاكرة والمهارات
X-Session-Idمفتاح ترابط الجلسة وإسناد التكلفة
Idempotency-Keyإزالة تكرار طلب أعيدت محاولته

اقرأ مرجع API