Felo API PlatformFelo API Platform

عام سوالات

بلنگ اور کریڈٹس

سروس کریڈٹ کیسے وصول ہوتے ہیں، کب ٹاپ اپ کرنا ہے، اور 402 جواب کا کیا مطلب ہے۔

API usage پیشگی ادا کی جاتی ہے، سوائے اس صورت کے جب کوئی اہل Felo API، Felo Pro subscription credits سے ادائیگی کر سکے۔ Model API calls کی ادائیگی ہمیشہ USD-denominated service credits سے ہوتی ہے۔

بلنگ کیسے کام کرتی ہے

  • top-up کے ذریعے service credits خریدی جاتی ہیں، نہ کہ platform کے پاس رکھی گئی cash balance۔
  • Credits کی denomination USD میں ہوتی ہے تاکہ charges کو dollars میں ظاہر کیا جا سکے۔
  • Top-ups $1 سے شروع ہوتی ہیں۔ کسی subscription کی ضرورت نہیں۔
  • Credits صرف platform API charges کو offset کرنے کے لیے استعمال ہوتی ہیں۔ انہیں نکالا نہیں جا سکتا اور نہ ہی cash کے بدلے تبدیل کیا جا سکتا ہے۔
  • مکمل شدہ top-ups non-refundable ہیں، unused credits سمیت، سوائے اس صورت کے جب لازمی قابلِ اطلاق قانون اس کے برخلاف تقاضا کرے۔

Platform balance، Model API، third-party Data API اور platform-exclusive Felo OpenAPI (/api/v1/data) کی ادائیگی کرتی ہے۔ موجودہ Felo APIs (/v2)، Felo Pro credits استعمال کرتی ہیں، جو الگ balance ہے۔

ایک درخواست کی قیمت کیا ہے

charge endpoint پر منحصر ہوتی ہے:

سطحبلنگ بنیاد
ماڈل APIinput، output، اور caching کے لیے token rates، نیز کوئی بھی قابلِ بلنگ tools؛ channel کا discount multiplier لاگو ہوتا ہے
ڈیٹا APIاس endpoint کے لیے شائع کی گئی بلنگ بنیاد، جو کامیاب درخواست، واپس کیے گئے آئٹم، یا حقیقی استعمال کے لحاظ سے ہو سکتی ہے
Felo APIs (/v2)Felo کھاتے کی مراعات اور کریڈٹ اصول؛ کریڈٹس کٹیں گے یا نہیں یہ عمل پر منحصر ہے
Data API میں Feloپلیٹ فارم توازن؛ فی درخواست، واپس کیا گیا نتیجہ یا بنی ہوئی صفحہ

Model prices، pricing page اور ہر model page پر فی 1M tokens کے حساب سے دکھائی جاتی ہیں۔ formula اور worked estimate کے لیے Models and Pricing دیکھیں۔

اپنا توازن چیک کریں اور رقم شامل کریں

Console Billing کھولیں۔ console آپ کا موجودہ credit balance، top-up amounts، اور usage records دکھاتی ہے۔ available payment methods آپ کے region پر منحصر ہیں اور checkout پر دکھائی جاتی ہیں۔

402 جواب

402 کا مطلب ہے کہ balance اس call کو cover نہیں کرتی:

{
  "status": 402,
  "code": "INSUFFICIENT_CREDITS",
  "message": "...",
  "request_id": "..."
}

کیا کرنا ہے:

  1. Console Billing میں balance چیک کریں۔
  2. top up کریں۔
  3. request دوبارہ بھیجیں۔ 402 rate limit نہیں ہے، اس لیے انتظار کرنے سے یہ clear نہیں ہوگی۔

async task کے لیے، submit پر 402 کا مطلب ہے کہ task کبھی بنائی ہی نہیں گئی۔ دوبارہ submit کرنے سے پہلے task کی status endpoint چیک کریں۔

بلنگ بمقابلہ رفتار حدود

یہ مختلف limits ہیں:

  • Credits اس بات کو limit کرتی ہیں کہ آپ کتنا خرچ کر سکتے ہیں۔ ختم ہونے پر 402 واپس آتا ہے۔
  • Rate limits اس بات کو limit کرتی ہیں کہ آپ کتنی تیزی سے call کر سکتے ہیں۔ ان میں سے کسی ایک کے exceed ہونے پر 429 واپس آتا ہے۔

429 headers اور retry rules کے لیے Errors, Limits, and Retries دیکھیں۔

Felo Pro کریڈٹس اور Felo APIs

/v2 کے تحت Felo APIs — Search، PPT Task، Mindmap، LiveDoc، Web Fetch، X Search، YouTube Subtitling، Landing Page، اور SuperAgent — اس وقت Felo Pro subscription credits قبول کرتی ہیں۔

Felo Pro credits، Model API یا /api/v1/data کے تحت نئے Felo OpenAPI endpoints کی ادائیگی نہیں کرتیں۔ دونوں کے لیے prepaid platform balance درکار ہے۔

اہلیت تبدیل ہو سکتی ہے۔ اپنے موجودہ balance اور usage کے لیے Console Billing چیک کریں۔

مؤثر paid Felo subscription والے accounts کے لیے /v2/chat rate-limit exemption ایک الگ benefit ہے؛ یہ calls کی billing کا طریقہ تبدیل نہیں کرتا۔

v2 قابلیت کے مطابق کریڈٹ اصول

Felo account entitlements استعمال کرنے کا مطلب یہ نہیں کہ ہر call credits منہا کرے۔ rule کا تعین operation کرتی ہے:

کارروائیکریڈٹس اور حدود
تلاش-مبنی چیٹ، ویب استخراج، YouTube سب ٹائٹلزv2 حوالہ میں محدود وقت کے لیے مفت کے طور پر درج؛ موجودہ کھاتے کی مراعات دستیابی طے کرتی ہیں، اور درخواست حدود پھر بھی لاگو ہوتی ہیں
Mindmap بناناv2 mindmap بنانے کا endpoint صارف کریڈٹس منہا نہیں کرتا
SuperAgent مکالمے، PPT بنانافی درخواست یکساں مقررہ کریڈٹ مقدار شائع نہیں کی گئی؛ کھاتے سے متعلق اجازتوں کے لیے endpoint اور request_id کے ساتھ معاونت سے رابطہ کریں
PPTX برآمدنئی برآمد شروع کرنے پر 10 Felo کریڈٹس مانگے جاتے ہیں؛ موجودہ برآمد کو پول کرنا یا اس کا ڈاؤن لوڈ URL تازہ کرنا دوبارہ چارج شروع نہیں کرتا

X subscription requirements اور per-result charging کے لیے X Search دیکھیں۔ یہ rules اصل /v2 APIs پر لاگو ہوتی ہیں۔ /api/v1/data کے تحت Felo endpoints، platform balance اور اپنی شائع شدہ prices استعمال کرتی ہیں۔

API کے ذریعے platform wallet records دیکھنے کے لیے، wallet usage queries دیکھیں، جن کے لیے login token درکار ہوتا ہے۔

بلنگ سوالات

متنازع charge یا ایسی top-up کے لیے جو موصول نہ ہوئی ہو، support سے درج ذیل کے ساتھ رابطہ کریں:

  • account email
  • charge کا تخمینی وقت
  • کسی متعلقہ error سے request_id
  • top-up amount اور payment reference

اپنی مکمل API key کبھی نہ بھیجیں۔

متعلقہ

مدد چاہیے؟