> Dành cho AI agent: hướng dẫn từng bước để thiết lập — [`/docs/agents.md`](https://gate.joingonka.ai/docs/agents.md), chỉ mục tài liệu — [`/llms.txt`](https://gate.joingonka.ai/llms.txt).

# Bảng giá và tài khoản

Giá các mô hình, phí nạp và rút tiền, tỷ giá GNK. API tài khoản theo khóa: số dư, chi tiêu theo ngày và theo mô hình, lịch sử giao dịch và nạp tiền.

## Giá model

Giá đã bao gồm mức chênh lệch của nền tảng 10%. Giá trị trực tiếp ở `GET /api/pricing`, không cần key.

| `model` | Đầu vào, $ cho 1M token | Đầu ra, $ cho 1M token | nGNK mỗi token: đầu vào / đầu ra |
| --- | ---: | ---: | ---: |
| `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 |

- Chi phí yêu cầu = token đầu vào × giá đầu vào + token đầu ra × giá đầu ra. Phần suy luận của model được tính là token đầu ra.
- Trừ tiền bằng GNK (1 GNK = 10⁹ `nGNK`); giá bằng đô la tính theo tỷ giá GNK $0.253.
- Trước mỗi yêu cầu, gateway đối chiếu số dư với ước tính chi phí; không đủ thì trả `402 insufficient_funds`.
- Sau khi đăng ký, tài khoản nhận 0.1 GNK — khoảng 3M token theo giá đầu vào.

## Phí

| Thao tác | Phí | Ghi chú |
| --- | --- | --- |
| Mức chênh lệch cho yêu cầu gọi model | 10% | Đã bao gồm trong giá ở trên. |
| Nạp GNK | miễn phí | Chuyển đến địa chỉ gateway kèm `memo` của bạn; ghi có tự động. |
| Nạp USDT | 5% → 2.5% | Thanh toán qua OxaPay; số tiền càng lớn, phí càng thấp — [Bậc phí USDT](https://gate.joingonka.ai/vi/docs/billing#usdt-tiers). |
| Nạp WGNK từ Ethereum | 1% | Trang trải phí gas của mạng Ethereum khi chuyển sang Gonka. |
| Rút GNK | 5% | Chỉ từ trang quản lý, tối thiểu 1 GNK. |
| Tỷ giá GNK | $0.253 | Dùng để tính tiền nạp và giá bằng đô la; tự động cập nhật. |

### Bậc phí USDT

Mức phí phụ thuộc số tiền nạp, ngưỡng tính bao gồm:

| Số tiền nạp | Phí |
| --- | ---: |
| từ $0 | 5% |
| từ $25 | 4.5% |
| từ $50 | 4% |
| từ $100 | 3.5% |
| từ $250 | 3% |
| từ $500 | 2.75% |
| từ $1000 | 2.5% |

## API tài khoản

Số dư, chi tiêu và tiền nạp đều truy cập được bằng chính key dùng để gọi model (`Authorization: Bearer jg-…`). Những yêu cầu này không tốn token.

Lỗi: không có key — `401 authentication_error`, tham số sai — `400 validation_error`, route dành cho trang quản lý mà dùng API key — `403 forbidden`.

### GET `/api/balance`

Số dư hiện tại.

| Trường | Mô tả |
| --- | --- |
| `balance_ngonka` | Số dư bằng nGNK — dạng chuỗi để không mất độ chính xác |
| `balance_usd` | Số dư bằng đô la theo tỷ giá hiện tại |
| `cost_per_token_ngonka` | Giá token đầu vào của model được đề xuất kèm mức chênh lệch, nGNK |
| `tokens_remaining` | Số token đầu vào mà số dư đủ dùng ở mức giá này — ước tính |

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

### GET `/api/usage`

Chi tiêu theo ngày: yêu cầu, token, chi phí.

- `period` — `day`, `week`, `month`, `quarter`, mặc định là `month`.
- Hoặc `from` và `to` theo định dạng `YYYY-MM-DD`, cả hai cùng lúc, tối đa 92 ngày — khi đó phản hồi trả về `period: custom`.
- `tz` — độ lệch tính bằng phút, giống `getTimezoneOffset()` trên trình duyệt: với UTC+3 là `-180`. Không có thì mặc định là UTC.

Phản hồi là một mảng các ngày với các trường `date, requests, tokens, costNgonka`. Bản ghi chi tiết về yêu cầu được lưu trong 90 ngày.

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

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

Chi tiêu theo model: tổng hợp trong `models` và chuỗi «khoảng thời gian × model» trong `series` — theo giờ khi `period=day`, ngược lại theo ngày. Tham số giống như `/api/usage`.

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

Chi tiêu theo key — `keys`. Tham số giống như `/api/usage`.

### GET `/api/transactions`

Lịch sử giao dịch: nạp tiền, trừ tiền cho yêu cầu, tiền thưởng, rút tiền.

- `limit` — tối đa 200, mặc định là 50; `offset` — độ dịch.
- `type` — bộ lọc: `DEPOSIT_USDT`, `DEPOSIT_GNK`, `DEPOSIT_FIAT`, `INFERENCE`, `REFERRAL_REWARD`, `BONUS`, `WITHDRAWAL`.
- `from` và `to` — ngày, bao gồm ngày kết thúc.

Phản hồi là các bản ghi với các trường `id, type, amountNgonka, feeNgonka, description, createdAt` và tổng số `total`. Các bản ghi `INFERENCE` cũ hơn 90 ngày sẽ được gộp thành một bản ghi mỗi ngày.

### GET `/api/deposits`

Chỉ nạp tiền. Tham số `limit`, `offset`, `from` và `to` giống như lịch sử giao dịch; trong phản hồi có `total`.

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

Thông tin nạp GNK: `address` và `memo`. Chuyển GNK đến địa chỉ này kèm `memo` — tiền sẽ được ghi có tự động.

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

Tỷ giá và phí nạp USDT: `gnk_usd_price`, `fee_percent`, `fee_tiers`.

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

Hóa đơn thanh toán bằng USDT: nội dung `{"amount": 25}` — số tiền bằng đô la từ 1 đến 10000; phản hồi trả về `payment_url`. Nếu tạm thời đóng nhận USDT — `503`.

### GET `/api/pricing`

Giá và phí không cần key: `models[]`, `deposit_usdt_fee_tiers`, tỷ giá GNK và tiền thưởng khi đăng ký.

### Chỉ trong trang cá nhân

Quản lý tài khoản nằm trong trang cá nhân [gate.joingonka.ai/dashboard](https://gate.joingonka.ai/dashboard). Những route này không dành cho tích hợp, một số trong đó phản hồi API key `403 forbidden`:

- API key — [gate.joingonka.ai/keys](https://gate.joingonka.ai/keys);
- rút GNK — từ 1 GNK;
- nạp bằng thẻ và địa chỉ người gửi WGNK;
- mã khuyến mãi;
- chương trình giới thiệu và cài đặt gửi thông báo.