چینلز اور فراہم کنندہ روٹنگ

ایک ماڈل کئی اپ اسٹریم فراہم کنندگان کے ذریعے فراہم ہو سکتا ہے۔ بطور ڈیفالٹ Felo آپ کے لیے فراہم کنندہ منتخب کرتا ہے۔ جب آپ کو کوئی مخصوص فراہم کنندہ درکار ہو تو X-Felo-Channel درخواست ہیڈر کے ساتھ ایک یا زیادہ عوامی چینل کوڈز بھیجیں۔

معاون endpoints

X-Felo-Channel ہر Model API جنریشن endpoint پر قبول کیا جاتا ہے:

یہ Data API (/v1/beta) یا Felo APIs (/v2) پر لاگو نہیں ہوتا۔

ہیڈر کی ویلیوز

ویلیو عوامی چینل کوڈز کی ترتیب وار، کوما سے الگ کی گئی فہرست ہے:

X-Felo-Channel: claude-cc
X-Felo-Channel: claude-cc,anthropic
X-Felo-Channel: default

عوامی Model API تفصیلات کے قواعد:

• ڈیفالٹ روٹ استعمال کرنے کے لیے ہیڈر نہ بھیجیں۔
• default صرف اکیلا استعمال ہونے پر درست ویلیو ہے۔ اِسے چینل کوڈز کے ساتھ نہ ملائیں۔
• عوامی چینل کوڈز کیٹلاگ میں ماڈل کے channels[].code فیلڈ سے آتے ہیں۔ کوڈ استعمال کریں، فراہم کنندہ کا ڈسپلے نام نہیں۔
• صرف قابلِ عمل، شائع شدہ چینلز روٹ کیے جا سکتے ہیں۔

ڈیفالٹ روٹنگ

جب آپ ہیڈر نہیں بھیجتے، یا default اکیلا بھیجتے ہیں، تو پلیٹ فارم فراہم کنندہ منتخب کرتا ہے۔ wallet موڈ میں یہ ماڈل کے موثر عوامی چینل آرڈر کو اُلٹ ترتیب میں اسکین کرتا ہے، غیر شائع شدہ یا غیر دستیاب چینلز چھوڑ دیتا ہے اور پہلے دستیاب چینل کا فراہم کنندہ منتخب کرتا ہے۔ یہ اُس فراہم کنندہ کے دستیاب endpoints شامل کر سکتا ہے جن کا اپ اسٹریم ماڈل ID اور سروس ٹیئر ایک ہی ہو۔

آپ کو X-Felo-Channel: default بھیجنے کی ضرورت نہیں؛ ہیڈر نہ بھیجنا ہی ڈیفالٹ روٹ استعمال کرنے کا معمول طریقہ ہے۔

واضح روٹنگ

جب آپ چینل کوڈز بھیجتے ہیں تو اُن کی توثیق آپ کی دی ہوئی ترتیب میں ہوتی ہے۔ صرف پہلے چینل کا فراہم کنندہ گروپ جمع کرایا جاتا ہے۔ کسی دوسرے فراہم کنندہ کی خودکار فال بیک نہیں ہوتی۔

اِس کا مطلب ہے کہ چینل فہرست ایک انتخاب ہے، دوبارہ کوشش کی پالیسی نہیں۔ اگر آپ کو فیل اوور درکار ہو تو اپنی ایپلیکیشن میں نافذ کریں: پہلے چینل کی ناکامی کے بعد مختلف چینل کے ساتھ نئی درخواست بھیجیں۔

پرانی فراہم کنندہ ہیڈرز X-Felo-Channel کو اوور رائیڈ نہیں کر سکتیں۔ اگر آپ کے کلائنٹ میں کوئی دوسرا ہیڈر بھی فراہم کنندہ طلب کرے تو X-Felo-Channel کو ترجیح ملتی ہے۔

قیمتیں

ہر عوامی چینل اپنے معیاری ریٹس اور ڈسکاؤنٹ ملٹی پلائر شائع کرتا ہے۔ ماڈل تفصیل کے صفحے پر کسی فراہم کنندہ کے لیے دکھائی جانے والی قیمت اُس چینل کی کسٹمر قیمت ہے۔ آپ کا پن کیا ہوا چینل طے کرتا ہے کہ کس فراہم کنندہ کا ریٹ لاگو ہوگا۔

کسی زیادہ حجم والے ورک لوڈ کے لیے چینل پن کرنے سے پہلے ماڈل صفحے پر فراہم کنندہ کی قطاریں موازنہ کریں اور ماڈلز اور قیمتیں پڑھیں۔

چینل کوڈ تلاش کریں

1. ماڈل تفصیل کا صفحہ کھولیں اور فراہم کنندہ کا جدول تلاش کریں۔
2. فراہم کنندہ کو اُس کے عوامی چینل کوڈ سے ملا دیں۔ کوڈ وہ مستحکم شناخت ہے جو API استعمال کرتا ہے۔
3. اگر آپ کیٹلاگ براہ راست پڑھ رہے ہیں تو channels[].code استعمال کریں اور runnable چیک کریں۔

مثال کے طور پر، claude-haiku-5-5 کئی چینلز شائع کرتا ہے، بشمول anthropic (ڈیفالٹ)، azure، google-vertex-global اور claude-cc۔ claude-cc قطار اپنا الگ ڈسکاؤنٹ دکھاتی ہے، لہٰذا اِسے پن کرنے سے فراہم کنندہ اور ریٹ دونوں بدل جاتے ہیں۔

مثالیں

ایک چینل سے پن شدہ Chat Completions:

curl https://openapi.felo.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Felo-Channel: claude-cc" \
  -d '{
    "model": "claude-haiku-5-5",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "Summarize this change in one sentence."}]
  }'

اُسی چینل کے ساتھ Anthropic Messages:

curl https://openapi.felo.ai/api/v1/messages \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Felo-Channel: claude-cc" \
  -d '{
    "model": "claude-haiku-5-5",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "Summarize this change in one sentence."}]
  }'

ڈیفالٹ روٹنگ، بغیر کسی روٹنگ ہیڈر کے:

curl https://openapi.felo.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-haiku-5-5",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "Summarize this change in one sentence."}]
  }'

متعلقہ

• Model API ریفرنس
• ماڈلز اور قیمتیں
• ایررز، حدود اور دوبارہ کوششیں