> 面向 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 token | 输出，$ / 1M token | 每 token 的 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 |

- 请求费用 = 输入 token 数 × 输入价格 + 输出 token 数 × 输出价格。模型推理计入输出 token。
- 扣费以 GNK 进行（1 GNK = 10⁹ `nGNK`）；美元价格按 GNK 汇率 $0.253 计算。
- 请求之前，网关会将余额与费用预估进行核对；余额不足时返回 `402 insufficient_funds`。
- 注册后，账户会收到 0.1 GNK — 按输入价格约合 3M 个 token。

## 手续费

| 操作 | 手续费 | 备注 |
| --- | --- | --- |
| 模型请求加价 | 10% | 已包含在上方价格中。 |
| GNK 充值 | 免费 | 转账到带有你的 `memo` 的网关地址；自动入账。 |
| USDT 充值 | 5% → 2.5% | 通过 OxaPay 支付；金额越大，手续费越低 — [USDT 费率阶梯](https://gate.joingonka.ai/zh/docs/billing#usdt-tiers)。 |
| 从 Ethereum 充值 WGNK | 1% | 用于支付转入 Gonka 时的 Ethereum 网络 gas。 |
| 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-…`）查询。这些请求不消耗 token。

错误：没有密钥 — `401 authentication_error`，参数无效 — `400 validation_error`，在控制台路由上使用 API 密钥 — `403 forbidden`。

### GET `/api/balance`

当前余额。

| 字段 | 说明 |
| --- | --- |
| `balance_ngonka` | nGNK 余额 — 以字符串返回，避免精度丢失 |
| `balance_usd` | 按当前汇率折算的美元余额 |
| `cost_per_token_ngonka` | 推荐模型含加价的输入 token 价格，nGNK |
| `tokens_remaining` | 按此价格，余额够用多少输入 token——估算值 |

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

### GET `/api/usage`

每日用量：请求数、token、费用。

- `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`。超过 90 天的 `INFERENCE` 记录会按天合并为一条。

### 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 发送方地址；
- 优惠码；
- 推荐计划和邮件推送设置。