> สำหรับเอเจนต์ 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/th/docs/billing#usdt-tiers) |
| การเติม WGNK จาก Ethereum | 1% | ครอบคลุมค่าแก๊สของเครือข่าย Ethereum เมื่อโอนเข้า Gonka |
| การถอน 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 key — `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` โอน GNK ไปยังที่อยู่นี้พร้อม `memo` นี้ — ระบบจะเพิ่มยอดอัตโนมัติ

### 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;
- โค้ดโปรโมชั่น;
- โปรแกรมแนะนำและตั้งค่าการแจ้งเตือน