بوابة LLM مع طبقة البيانات مرفقة

ست نقاط نهاية، لا واحدة

كل ما يقع تحت /api/v1 هو استدعاء نموذج، لكن نوع النموذج يحدد أي نقطة نهاية يمكنها الرد — وكل نقطة تعيد تنسيقها الخاص.

واجهات المحادثة الثلاث تطبيقات أصلية لا طبقة ترجمة: كل واحدة ترسل أحداثها ببروتوكولها الخاص، لذا تُحلّل البث كما تفعل اليوم تمامًا.

اختر نقطة النهاية حسب نوع النموذج، لا بالتخمين

كل نموذج في الكتالوج يحمل model_kind، والنوع يحدد أي نقطة نهاية يمكنها استدعاؤه. الاستكشاف مجاني: يقرأ الكتالوج المحلي.

# discover before you call — free, reads the catalog
GET /api/v1/models   # every kind, with channels and rates
GET /api/v1/models/{model_id}  # one model, in detail
GET /api/v1/videos/models     # video_generation only
GET /api/v1/decisions/models  # decisions only

استخدم ?provider= لعرض مزوّد واحد، أو ?exclude_video_and_decisions=true لإخفاء كل شيء عدا المحادثة والصور. وجود النموذج في الكتالوج ليس وعدًا: نموذج الفيديو لا يجيب طلب محادثة، ويعيد API الخطأ model_kind_mismatch.

مسار افتراضي، أو ترويسة لاختيار المزوّد

قد يخدم النموذج أكثر من قناة منبعية، لكل قناة مزوّدها وسعرها المعلن. بدون الترويسة تختار المنصة واحدة؛ ومع X-Felo-Channel تختار أنت.

# first channel only — no automatic fallback
X-Felo-Channel: claude-cc
X-Felo-Channel: claude-cc,anthropic  # ordered selection, not a retry list

• القيمة قائمة مرتبة من رموز القنوات العامة المأخوذة من channels[].code للنموذج، وتُتحقق بالترتيب الذي تكتبه.
• تُستدعى مجموعة مزوّدي القناة الأولى فقط، وتدفع سعر تلك القناة.
• لا يوجد تحويل تلقائي. قائمة القنوات اختيار لا سياسة إعادة محاولة — إذا فشل مزوّد فأعد الإرسال من تطبيقك بقناة أخرى.

تعمل X-Felo-Channel على نقاط التوليد الست أعلاه. لا تنطبق على واجهة البيانات ولا على Felo APIs: تلك الاستدعاءات تذهب إلى المزوّد الذي تسمّيه في الطلب.

كم يكلّف الاستدعاء فعليًا

تُحاسب استدعاءات النماذج بالوحدة الرمزية — إدخال وإخراج وتخزين مؤقت — مع مضاعف الخصم الخاص بالقناة. تُعرض الأسعار لكل مليون وحدة للقراءة، لكن الفوترة تستخدم الدقة الرمزية من لقطة الأسعار الحالية: الطلب القصير لا يُقرّب إلى مليون أبدًا.

• تنطبق أسعار التخزين المؤقت فقط عندما يبلّغ رد البروتوكول عن استخدام التخزين المؤقت؛ النموذج الذي لا يبلّغ يحتسب كل شيء بسعر الإدخال.
• البحث عبر الويب الذي تنفذه خدمة النموذج وتبلّغ عنه يكلّف $0.01 لكل بحث.
• بعض النماذج متدرجة حسب حجم الطلب: Claude Haiku 5.5 يكلّف $0.10 إدخالًا و$0.50 إخراجًا لكل مليون وحدة حتى طلب من 100K وحدة، وما فوق ذلك $0.50 و$2.50 للطلب كله.
• أول شحن بمقدار $1. لا اشتراك، ولا رسم لكل مستخدم، ولا حد أدنى للالتزام — المفتاح غير المستخدَم لا يكلّف شيئًا.

تُخصم استدعاءات واجهة البيانات وسير عمل Felo من الرصيد نفسه، كلٌّ وفق أساسه المعلن: لكل طلب ناجح، أو لكل عنصر معاد، أو حسب الاستخدام الفعلي.

حدّان يبدوان متشابهين وليسا كذلك

نفاد الرصيد يعيد 402 INSUFFICIENT_CREDITS. الاستدعاء السريع المفرط يعيد 429 RATE_LIMITED. الانتظار يحل الثاني ولا يحل الأول أبدًا.

اليوم يوثّق /v2/chat وحده حدودًا صارمة. قد تُقيَّد استدعاءات النماذج من المنبع أيضًا، ويظهر ذلك برمز 429 — اقرأ X-RateLimit-* وRetry-After بدل تثبيت الأرقام. كل رد يحمل request_id، وترويسة X-Request-Id التي ترسلها تعود كما هي، فتتقاطع سجلاتك مع سجلاتنا.

الصور والفيديو تكتمل في الخلفية

تعيد نقطتا التوليد task_id بدل النتيجة. أرسل، استعلم، استلم — وانتبه: بعد إنشاء المهمة تأتي معظم حالات الفشل برد 200 مع حالة نهائية، لا بخطأ HTTP.

# submit, then poll the task
POST /api/v1/images/generations       → task_id
GET  /api/v1/images/generations/{id}  → status, result
POST /api/v1/videos/generations       → task_id
GET  /api/v1/videos/generations/{id}  → status, result

اقرأ الحالة قبل النتيجة: failed وinterrupted ردود أيضًا، ويوضح error.message السبب. وجود 402 عند الإرسال يعني أن المهمة لم تُنشأ قط. يعمل SuperAgent بشكل مختلف: يعيد stream_key ويدفع الأحداث عبر SSE، فلا شيء للاستعلام عنه.

غيّر العنوان الأساسي واحتفظ بالعميل

يعمل SDKان دون تعديل بمجرد توجيه العنوان الأساسي إلى هنا. يكتب npx feloapi-cli setup الإعداد نفسه لـ Claude Code وCodex.

# OpenAI SDK
base_url = "https://openapi.felo.ai/api/v1"

# Anthropic SDK — one level up; the SDK appends /v1/messages
base_url = "https://openapi.felo.ai/api"

# pin a provider (optional)
default_headers = {"X-Felo-Channel": "claude-cc"}

معرّفات النماذج ليست متطابقة بين المزوّدين. اختر من الكتالوج قبل تبديل العنوان الأساسي، وإلا رد الاستدعاء الأول بـ 404.

النصف الذي تتركه البوابة لك عادةً

بوابة LLM توجّه استدعاءات النماذج. هنا يصل المفتاح نفسه إلى كتالوج فيه ⁦5,000+⁩ من الواجهات — فخطوة البحث في وكيلك، والشرائح التي ينتجها، والمستند الذي يعيد قراءته، تُحاسب من الأرصدة نفسها لا من ثلاثة مزوّدين إضافيين.

• Search
• PPT Task
• SuperAgent
• Web Fetch
• X Search
• Mindmap
• Landing Page Task
• LiveDoc
• YouTube Subtitling

تذهب استدعاءات واجهة البيانات إلى مزوّدين مسمّين تحت /v1/beta — Tavily وExa وApollo وبقية الكتالوج — كلٌّ وفق أساسه المعلن.

ستة أسئلة عن بوابة LLM