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

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

API کا استعمال متعلقہ شرائط کے تحت بل کیا جاتا ہے۔ مفت کریڈٹس وقت اور مقدار، دونوں کے لحاظ سے محدود ہیں۔ بامعاوضہ Model API کا استعمال امریکی ڈالر (USD) میں متعین پلیٹ فارم سروس کریڈٹس کے ذریعے بل کیا جاتا ہے؛ اہل Felo APIs کے لیے Felo Pro سبسکرپشن کریڈٹس استعمال کیے جا سکتے ہیں۔

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

- 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 پر منحصر ہوتی ہے:

| سطح | بلنگ بنیاد |
| --------- | --------------- |
| ماڈل API | input، output، اور caching کے لیے token rates، نیز کوئی بھی قابلِ بلنگ tools؛ channel کا discount multiplier لاگو ہوتا ہے |
| ڈیٹا API | اس endpoint کے لیے شائع کی گئی بلنگ بنیاد، جو کامیاب درخواست، واپس کیے گئے آئٹم، یا حقیقی استعمال کے لحاظ سے ہو سکتی ہے |
| Felo APIs (`/v2`) | Felo کھاتے کی مراعات اور کریڈٹ اصول؛ کریڈٹس کٹیں گے یا نہیں یہ عمل پر منحصر ہے |
| [Data API میں Felo](https://openapi.felo.ai/ur/docs/api-reference/openapi/billing.md) | پلیٹ فارم توازن؛ فی درخواست، واپس کیا گیا نتیجہ یا بنی ہوئی صفحہ |

Model prices، [pricing page](https://openapi.felo.ai/ur/pricing) اور ہر model page پر فی 1M tokens کے حساب سے دکھائی جاتی ہیں۔ formula اور worked estimate کے لیے [Models and Pricing](https://openapi.felo.ai/ur/docs/guides/models-and-pricing.md) دیکھیں۔

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

[Console Billing](https://openapi.felo.ai/console/billing) کھولیں۔ console آپ کا موجودہ credit balance، top-up amounts، اور usage records دکھاتی ہے۔ available payment methods آپ کے region پر منحصر ہیں اور checkout پر دکھائی جاتی ہیں۔

## 402 جواب

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

```json
{
  "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](https://openapi.felo.ai/ur/docs/guides/errors-and-limits.md) دیکھیں۔

## 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 کریڈٹس، `/api/v1/data` کے تحت Model API یا نئے Felo OpenAPI endpoints کی ادائیگی کے لیے استعمال **نہیں** کیے جا سکتے۔ ان APIs کے بامعاوضہ استعمال کا بل پلیٹ فارم سروس کریڈٹس کے ذریعے ادا کیا جاتا ہے۔

اہلیت تبدیل ہو سکتی ہے۔ اپنے موجودہ balance اور usage کے لیے [Console Billing](https://openapi.felo.ai/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](https://openapi.felo.ai/ur/docs/api-reference/x-search.md) دیکھیں۔ یہ rules اصل `/v2` APIs پر لاگو ہوتی ہیں۔ `/api/v1/data` کے تحت Felo endpoints، platform balance اور اپنی شائع شدہ prices استعمال کرتی ہیں۔

API کے ذریعے platform wallet records دیکھنے کے لیے، [wallet usage queries](https://openapi.felo.ai/ur/docs/api-reference/openapi/billing.md#api) دیکھیں، جن کے لیے login token درکار ہوتا ہے۔

## بلنگ سوالات

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

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

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

## متعلقہ

- [Pricing](https://openapi.felo.ai/ur/pricing)
- [Models and Pricing](https://openapi.felo.ai/ur/docs/guides/models-and-pricing.md)
- [Errors, Limits, and Retries](https://openapi.felo.ai/ur/docs/guides/errors-and-limits.md)
- [API terms](https://openapi.felo.ai/api-terms)
