> 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/bn/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 প্রেরকের ঠিকানা;
- প্রোমো কোড;
- রেফারেল প্রোগ্রাম এবং নিউজলেটার সেটিংস।