USER GUIDE
5 分钟接入 TokenGP
从注册到调通第一个模型，一份文档讲清楚。所有步骤都是 OpenAI 兼容接口，零迁移成本。
总览 · 5 步走通
注册 → 充值 → 创建 Key → 调用 → 看用量
1
注册账号
邮箱密码注册，立即可用
2
钱包充值
在线充值（支付宝 / 微信支付，即将上线），也可联系客服对公充值
3
创建 API Key
设定名称、RPM、余额上限，密钥仅展示一次
4
调用模型
OpenAI 兼容 SDK 零迁移，110+ 模型可选
5
查看用量
实时余额、流水、按模型 / Key 维度的统计
① 注册账号
邮箱密码注册，30 秒搞定
② 充值你的钱包
在线充值即将上线，当前可联系客服对公充值
在线充值
支付宝 / 微信支付正在接入，即将上线，届时可随时按需充值。
对公充值
可随时联系客服或商务对接，通过对公转账完成充值。
邀请返佣
默认 L1 5% / L2 2% 二级返佣，邀请的好友每次消费实时入账（具体比例以注册时所在租户配置为准）。
在线充值升级中。支付宝 / 微信支付即将上线；在此之前如需充值，请联系客服或商务对接，通过对公转账完成。
③ 创建 API Key
可创建任意多把，分别设独立限额
- 1进 /keys 页面点 "Create Key"
填名字（必填）、可选 RPM 上限、可选累计消费上限、可选过期时间。
- 2立即复制完整 Key 并保存
Key 格式：
sk-tokengp-XXXXXXXX...。仅创建窗口展示一次，关闭后再也看不到。 - 3配到 SDK 或环境变量
建议放环境变量
TOKENGP_KEY，不要硬编码、不要 commit。
Key 泄露怎么办？进 /keys 把它 disable，新建一把。泄露期间产生的费用属于真实消费，不退款。
④ 调用第一个模型
OpenAI 兼容，已有代码改 base_url 就能用
💬 对话（chat completions）
curl
curl https://api.tokengp.com/v1/chat/completions \
-H "Authorization: Bearer $TOKENGP_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen-flash",
"messages": [{"role":"user","content":"Hello, TokenGP!"}]
}'🐍 Python OpenAI SDK
python
from openai import OpenAI
client = OpenAI(
base_url="https://api.tokengp.com/v1",
api_key="sk-tokengp-...",
)
resp = client.chat.completions.create(
model="qwen-flash",
messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)🔢 文本嵌入
curl
curl https://api.tokengp.com/v1/embeddings \
-H "Authorization: Bearer $TOKENGP_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"text-embedding-v4","input":"Hello world"}'🎨 图像生成
curl
curl https://api.tokengp.com/v1/images/generations \
-H "Authorization: Bearer $TOKENGP_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"qwen-image-plus","prompt":"red apple","size":"1024x1024"}'主流模型可选：通义千问 / DeepSeek / Kimi / 智谱 GLM 等，点这里看完整定价。
⑤ 看用量和余额
实时账单 + 多维度统计 + 邀请返佣
💼
/dashboard
当前余额、本月消费、近 30 天调用量、平均延迟、最近 5 条调用、趋势图。
📊
/usage
选时间段，看总调用、总 Token、总消费；按日 / 模型 / Key 切片。
🤝
/referral
专属邀请码 + 邀请链接。L1 5% + L2 2% 实时入账。
常见错误码速查
按这张表找对应解法
| HTTP | 错误码 | 原因 + 解法 |
|---|---|---|
| 401 | missing_key / invalid_key | Authorization header 缺失、Key 拼错或拷贝时漏了字符 |
| 402 | insufficient_balance | 余额不足，及时充值 |
| 402 | cap_reached | 这把 Key 设了累计上限并已达到，新建一把或调高上限 |
| 403 | account_suspended | 账户被风控暂停，联系客服 |
| 403 | disabled | Key 被禁用，启用或新建一把 |
| 404 | model_not_found | 模型代码拼错或已下线，去 /models 看可用列表 |
| 429 | rate_limit_exceeded | 触发 Key 级 RPM 限制 |
| 503 | upstream_unavailable | 上游临时不可用，重试或换备用模型 |