面向 AI 智能体：配置分步指南 — /docs/agents.md，文档索引 — /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 费率阶梯。 |
| 从 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——估算值 |
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 天。
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 中进行。这些路由不适用于集成，其中一部分对 API 密钥返回 403 forbidden：
- API 密钥——gate.joingonka.ai/keys；
- GNK 提现——最低 1 GNK；
- 银行卡充值和 WGNK 发送方地址；
- 优惠码；
- 推荐计划和邮件推送设置。