> AI ایجنٹس کے لیے: سیٹ اپ کی مرحلہ وار ہدایات — [`/docs/agents.md`](https://gate.joingonka.ai/docs/agents.md)، دستاویزات کا انڈیکس — [`/llms.txt`](https://gate.joingonka.ai/llms.txt)۔

# قیمتیں اور اکاؤنٹ

ماڈلز کی قیمتیں، جمع اور نکاسی کی فیس، GNK ریٹ۔ کی کے ذریعے اکاؤنٹ API: بیلنس، روزانہ اور ماڈل کے لحاظ سے خرچ، لین دین کی تاریخ اور ٹاپ اپ۔

## ماڈلز کی قیمتیں

قیمتوں میں پہلے سے 10% پلیٹ فارم مارک اپ شامل ہے۔ لائیو اقدار — `GET /api/pricing`، بغیر کی۔

| `model` | ان پٹ، $ فی 1M ٹوکنز | آؤٹ پٹ، $ فی 1M ٹوکنز | فی ٹوکن nGNK: ان پٹ / آؤٹ پٹ |
| --- | ---: | ---: | ---: |
| `MiniMaxAI/MiniMax-M2.7` | $0.008349 | $0.02505 | 33 / 99 |
| `deepseek-ai/DeepSeek-V4-Flash-0731` | $0.008349 | $0.02505 | 33 / 99 |
| `zai-org/GLM-5.3-Flash` | $0.008349 | $0.02505 | 33 / 99 |

- درخواست کی لاگت = ان پٹ ٹوکنز × ان پٹ قیمت + آؤٹ پٹ × آؤٹ پٹ قیمت۔ ماڈل کی ریزننگ آؤٹ پٹ ٹوکنز کے طور پر شمار ہوتی ہے۔
- کٹوتی — GNK میں (1 GNK = 10⁹ `nGNK`); ڈالر میں قیمتیں — GNK ریٹ $0.253 کے مطابق۔
- درخواست سے پہلے گیٹ وے لاگت کے تخمینے سے بیلنس ملتا ہے؛ کافی نہ ہو تو — `402 insufficient_funds`۔
- رجسٹریشن کے بعد اکاؤنٹ میں 0.1 GNK آتے ہیں — ان پٹ قیمت پر تقریباً 3M ٹوکنز۔

## فیس

| آپریشن | فیس | نوٹ |
| --- | --- | --- |
| ماڈل درخواستوں پر مارک اپ | 10% | پہلے سے اوپر کی قیمتوں میں شامل۔ |
| GNK ری چارج | مفت | آپ کے `memo` کے ساتھ گیٹ وے ایڈریس پر ٹرانسفر؛ خودکار جمع۔ |
| USDT ری چارج | 5% → 2.5% | OxaPay کے ذریعے ادائیگی؛ رقم جتنی زیادہ، فیس اتنی کم — [USDT فیس کی سیڑھی](https://gate.joingonka.ai/ur/docs/billing#usdt-tiers)۔ |
| Ethereum سے WGNK ری چارج | 1% | Gonka میں ٹرانسفر کے وقت Ethereum نیٹ ورک کی گیس کور کرتا ہے۔ |
| GNK ویدھڈرال | 5% | صرف کابینہ سے، 1 GNK سے۔ |
| GNK ریٹ | $0.253 | اسی سے ری چارجز اور ڈالر میں قیمتیں شمار ہوتی ہیں؛ خودکار اپ ڈیٹ۔ |

### USDT فیس کی سیڑھی

شرح ری چارج کی رقم پر منحصر ہے، حد شامل ہے:

| ری چارج کی رقم | فیس |
| --- | ---: |
| $0 سے | 5% |
| $25 سے | 4.5% |
| $50 سے | 4% |
| $100 سے | 3.5% |
| $250 سے | 3% |
| $500 سے | 2.75% |
| $1000 سے | 2.5% |

## اکاؤنٹ API

بیلنس، خرچ اور ری چارجز اسی کی سے دستیاب ہیں جو ماڈل درخواستوں کے لیے ہے (`Authorization: Bearer jg-…`)。 یہ درخواستیں ٹوکنز خرچ نہیں کرتیں۔

ایررز: بغیر کی — `401 authentication_error`، غلط پیرامیٹرز — `400 validation_error`، API کی کے ساتھ کابینہ روٹ — `403 forbidden`۔

### GET `/api/balance`

موجودہ بیلنس۔

| فیلڈ | تفصیل |
| --- | --- |
| `balance_ngonka` | nGNK میں بیلنس — درستگی نہ کھونے کے لیے اسٹرنگ کے طور پر |
| `balance_usd` | موجودہ ریٹ پر ڈالر میں بیلنس |
| `cost_per_token_ngonka` | تجویز کردہ ماڈل کے ان پٹ ٹوکن کی قیمت مارک اپ کے ساتھ، nGNK |
| `tokens_remaining` | اس قیمت پر بیلنس سے کتنے اِن پُٹ ٹوکن پورے ہوں گے — ایک تخمینہ |

```bash
curl -s https://gate.joingonka.ai/api/balance \
  -H "Authorization: Bearer $JOINGONKA_API_KEY"
```

### GET `/api/usage`

روزانہ کا خرچ: درخواستیں، ٹوکن، لاگت۔

- `period` — `day`, `week`, `month`, `quarter`، ڈیفالٹ `month`۔
- یا `from` اور `to` `YYYY-MM-DD` فارمیٹ میں، دونوں ایک ساتھ، 92 دن تک — تب جواب میں `period: custom`۔
- `tz` — منٹوں میں آفسیٹ، براؤزر کے `getTimezoneOffset()` کی طرح: UTC+3 کے لیے — `-180`۔ اس کے بغیر — UTC۔

جواب — `date, requests, tokens, costNgonka` فیلڈز کے ساتھ دنوں کی اَری۔ درخواستوں کے تفصیلی ریکارڈ 90 دن محفوظ رہتے ہیں۔

```bash
curl -s "https://gate.joingonka.ai/api/usage?period=week&tz=-180" \
  -H "Authorization: Bearer $JOINGONKA_API_KEY"
```

### GET `/api/usage/by-model`

ماڈل کے لحاظ سے خرچ: `models` میں مجموعے اور `series` میں «مدت × ماڈل» سیریز — `period=day` ہو تو گھنٹے، ورنہ دن۔ پیرامیٹرز — `/api/usage` کی طرح۔

### GET `/api/usage/by-key`

کیز کے لحاظ سے خرچ — `keys`۔ پیرامیٹرز — `/api/usage` کی طرح۔

### GET `/api/transactions`

لین دین کی تاریخ: ڈپازٹ، درخواستوں کے چارجز، بونس، وتھ ڈرال۔

- `limit` — زیادہ سے زیادہ 200، ڈیفالٹ 50; `offset` — آفسیٹ۔
- `type` — فلٹر: `DEPOSIT_USDT`, `DEPOSIT_GNK`, `DEPOSIT_FIAT`, `INFERENCE`, `REFERRAL_REWARD`, `BONUS`, `WITHDRAWAL`۔
- `from` اور `to` — تاریخیں، آخری دن شامل۔

جواب — `id, type, amountNgonka, feeNgonka, description, createdAt` فیلڈز کے ساتھ ریکارڈز اور کل تعداد `total`۔ `INFERENCE` والے ریکارڈز 90 دن سے پرانے ہو جائیں تو فی دن ایک میں سمیٹ دیے جاتے ہیں۔

### GET `/api/deposits`

صرف ڈپازٹ۔ پیرامیٹرز `limit`، `offset`، `from` اور `to` — لین دین کی تاریخ کی طرح؛ جواب میں `total` موجود ہوتا ہے۔

### POST `/api/deposit/gnk`

GNK ڈپازٹ کی تفصیلات: `address` اور `memo`۔ اسی `memo` کے ساتھ اس ایڈریس پر GNK بھیجیں — رقم خودکار طور پر جمع ہو جائے گی۔

### GET `/api/deposit/usdt/rate`

USDT ڈپازٹ کی شرح اور فیس: `gnk_usd_price`، `fee_percent`، `fee_tiers`۔

### POST `/api/deposit/usdt`

USDT میں ادائیگی کا انوائس: باڈی `{"amount": 25}` — ڈالر میں رقم 1 سے 10000 تک؛ جواب میں `payment_url`۔ USDT وصولی عارضی طور پر بند ہو تو — `503`۔

### GET `/api/pricing`

بغیر کی کے قیمتیں اور فیس: `models[]`، `deposit_usdt_fee_tiers`، GNK ریٹ اور رجسٹریشن پر بونس۔

### صرف ڈیش بورڈ میں

اکاؤنٹ کا انتظام — [gate.joingonka.ai/dashboard](https://gate.joingonka.ai/dashboard) ڈیش بورڈ میں۔ یہ روٹس انٹیگریشن کے لیے نہیں، ان میں سے کچھ API کی کو `403 forbidden` جواب دیتے ہیں:

- API کیز — [gate.joingonka.ai/keys](https://gate.joingonka.ai/keys);
- GNK وتھ ڈرال — 1 GNK سے;
- کارڈ سے ڈپازٹ اور WGNK بھیجنے والوں کے ایڈریس;
- پرومو کوڈز;
- ریفرل پروگرام اور نیوز لیٹر کی سیٹنگز۔