ڈیٹا لیئر کے ساتھ آنے والا 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 اوپر دیے گئے چھ جنریشن اینڈ پوائنٹس پر کام کرتا ہے۔ یہ ڈیٹا API یا Felo APIs پر لاگو نہیں: وہ کالیں اُس فراہم کنندہ کو جاتی ہیں جس کا نام آپ درخواست میں دیتے ہیں۔

ایک کال کی اصل قیمت

ماڈل کالز ٹوکن کے حساب سے بل ہوتی ہیں — ان پٹ، آؤٹ پٹ اور کیش — چینل کے ڈسکاؤنٹ ضرب کے ساتھ۔ ریٹس پڑھنے کی سہولت کے لیے فی ملین ٹوکن دکھائے جاتے ہیں، مگر بلنگ موجودہ قیمت اسنیپ شاٹ کی فی ٹوکن درستگی سے ہوتی ہے: مختصر درخواست کبھی ملین تک گول نہیں ہوتی۔

• کیش ریٹس صرف اُس وقت لاگو ہوتے ہیں جب پروٹوکول کا جواب کیش کے استعمال کی اطلاع دے؛ جو ماڈل اطلاع نہیں دیتا وہ سب کچھ ان پٹ ریٹ پر گنتا ہے۔
• ویب تلاش جو ماڈل سروس خود چلا کر اس کی اطلاع دے، اس کی قیمت $0.01 فی تلاش ہے۔
• کچھ ماڈلز پرامپٹ کے حجم کے حساب سے درجہ بند ریٹ لیتے ہیں: Claude Haiku 5.5 پر 100K ٹوکن تک پرامپٹ پر $0.10 ان پٹ اور $0.50 آؤٹ پٹ فی ملین ٹوکن ہے، اس سے بڑے پر پوری درخواست کے لیے $0.50 اور $2.50۔
• پہلا ری چارج $1 ہے۔ کوئی سبسکرپشن نہیں، فی صارف فیس نہیں، کم از کم وعدہ نہیں — غیر استعمال شدہ کلید پر کوئی خرچ نہیں۔

ڈیٹا API کالز اور Felo ورک فلو بھی اسی بیلنس سے کٹتے ہیں، ہر ایک اپنی اعلان کردہ بنیاد پر: فی کامیاب درخواست، فی واپس شدہ آئٹم، یا حقیقی استعمال کے مطابق۔

دو حدیں جو ایک جیسی لگتی ہیں اور نہیں ہیں

بیلنس ختم ہونے پر 402 INSUFFICIENT_CREDITS آتا ہے۔ بہت تیز کال پر 429 RATE_LIMITED۔ انتظار دوسری کو ٹھیک کرتا ہے اور پہلی کو کبھی نہیں۔

آج صرف /v2/chat سخت حدیں دستاویز کرتا ہے۔ ماڈل کالز اپ اسٹریم سے بھی محدود ہو سکتی ہیں، جو 429 کی صورت میں دکھتا ہے — اعداد ہارڈ کوڈ کرنے کے بجائے X-RateLimit-* اور Retry-After پڑھیں۔ ہر جواب میں request_id ہوتا ہے، اور آپ جو X-Request-Id بھیجتے ہیں وہ جوں کا توں واپس آتا ہے، تاکہ آپ کے اور ہمارے لاگز مل سکیں۔

تصویر اور ویڈیو پس منظر میں مکمل ہوتے ہیں

دونوں جنریشن اینڈ پوائنٹس نتیجے کے بجائے task_id واپس کرتے ہیں۔ بھیجیں، پوچھیں، لیں — اور غور کریں: ٹاسک بننے کے بعد زیادہ تر ناکامیاں HTTP غلطی کے بجائے 200 کے ساتھ آخری اسٹیٹس کی صورت میں آتی ہیں۔

# 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 سے بھیجتا ہے، اس لیے پوچھنے کو کچھ نہیں۔

بنیادی URL بدلیں، کلائنٹ رکھیں

بنیادی URL یہاں کی طرف اشارہ کرتے ہی دونوں 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"}

ماڈل IDs ہر فراہم کنندہ میں یکساں نہیں۔ بنیادی URL بدلنے سے پہلے کیٹلاگ سے چنیں، ورنہ پہلی کال 404 واپس کرے گی۔

وہ آدھا حصہ جو گیٹ وے عام طور پر آپ پر چھوڑ دیتا ہے

LLM گیٹ وے ماڈل کالز کو روٹ کرتا ہے۔ یہاں وہی کلید ⁦5,000+⁩ APIs پر مشتمل کیٹلاگ تک بھی پہنچتی ہے — اس لیے آپ کے ایجنٹ کا تلاش کا مرحلہ، اس کی بنائی سلائیڈز اور اس کا دوبارہ پڑھا گیا دستاویز اُنہی کریڈٹس سے بل ہوتے ہیں، مزید تین فراہم کنندگان سے نہیں۔

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

ڈیٹا API کالز /v1/beta کے نیچے نامزد فراہم کنندگان کو جاتی ہیں — Tavily، Exa، Apollo اور باقی کیٹلاگ — ہر ایک اپنی اعلان کردہ بنیاد پر۔

LLM گیٹ وے کے بارے میں چھ سوالات