TokenGod 手动接入教程
本文档用于帮助你在代码、桌面客户端、AI IDE、Claude Code 类工具和自动化脚本中接入 TokenGod。TokenGod 使用 OpenAI 兼容接口，绝大多数支持自定义 OpenAI Base URL 的工具都可以配置。
准备工作
- 注册并登录 TokenGod。
- 进入 控制台 -> 令牌管理 创建 API Key。
- 确认账户有可用额度。
- 在 模型广场 或控制台确认你能使用的模型名称。
不要把 API Key 发给别人，也不要提交到 GitHub、Gitee、公开脚本或截图里。泄露后请立即删除旧令牌并重新创建。
接口地址
OpenAI 兼容 Base URL
https://tokengod.cc/v1聊天补全接口
https://tokengod.cc/v1/chat/completionsAnthropic Messages 兼容接口
https://tokengod.cc/v1/messages大多数客户端只需要填写 https://tokengod.cc/v1。如果客户端要求填写完整接口地址，再使用 /chat/completions 或 /messages。
创建令牌
- 打开 控制台 -> 令牌管理。
- 点击添加令牌。
- 设置令牌名称、额度限制和可用分组。
- 保存后复制
sk-开头的 API Key。
如果你看不到某些模型，通常是当前账号或令牌没有对应分组权限。
手动配置通用格式
| 字段 | 填写内容 |
|---|---|
| API 类型 / Provider | OpenAI Compatible、OpenAI 兼容、自定义 OpenAI |
| Base URL / API 地址 | https://tokengod.cc/v1 |
| API Key | 你在令牌管理中创建的 sk-... |
| Model / 模型 | 填写模型广场或后台显示的模型名，例如 gpt-4o-mini |
第三方客户端配置
| 客户端 | 配置方式 | 备注 |
|---|---|---|
| Cherry Studio | 供应商选择 OpenAI Compatible，API 地址填 https://tokengod.cc/v1 | Key 填 TokenGod 令牌。 |
| ChatBox | 模型供应方选择 OpenAI API 或自定义 OpenAI | Base URL 填 https://tokengod.cc/v1。 |
| NextChat | 设置中自定义接口地址 | 不要把地址填成根域名，要带 /v1。 |
| LobeChat | OpenAI Provider 中设置自定义代理地址 | Base URL 使用 https://tokengod.cc/v1。 |
| OpenCat | Team / Provider 中添加 OpenAI 兼容服务 | Domain 填 https://tokengod.cc 或 Base URL 填 https://tokengod.cc/v1，按客户端提示选择。 |
| DeepChat / AionUI | 添加 OpenAI Compatible Provider | 填入 API 地址、Key 和模型名。 |
Claude Code / CCSwitch 类工具
不同工具对 Claude、OpenAI 兼容端点的命名不完全一样。原则是：只要工具支持自定义 OpenAI Base URL，就优先按 OpenAI 兼容方式配置。
OpenAI 兼容模式
Base URL: https://tokengod.cc/v1
API Key: sk-你的令牌
Model: 你的可用模型名环境变量示例
export OPENAI_API_KEY="sk-你的令牌"
export OPENAI_BASE_URL="https://tokengod.cc/v1"Anthropic Messages 兼容模式
如果工具明确要求 Anthropic/Claude 接口，并支持自定义 Base URL，可尝试：
ANTHROPIC_BASE_URL=https://tokengod.cc/v1
ANTHROPIC_API_KEY=sk-你的令牌Claude Code、CCSwitch、各类代理工具版本差异较大。若配置后报模型不存在，请先确认你的账号分组有 Claude 模型权限，并使用站内可用的模型名。
代码示例
curl
curl https://tokengod.cc/v1/chat/completions \
-H "Authorization: Bearer sk-你的令牌" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o-mini",
"messages": [
{"role": "user", "content": "你好，介绍一下你自己"}
]
}'Python
from openai import OpenAI
client = OpenAI(
api_key="sk-你的令牌",
base_url="https://tokengod.cc/v1",
)
response = client.chat.completions.create(
model="gpt-4o-mini",
messages=[
{"role": "user", "content": "你好"}
],
)
print(response.choices[0].message.content)Node.js
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "sk-你的令牌",
baseURL: "https://tokengod.cc/v1",
});
const response = await client.chat.completions.create({
model: "gpt-4o-mini",
messages: [
{ role: "user", content: "你好" },
],
});
console.log(response.choices[0].message.content);模型名称和分组
TokenGod 的可用模型取决于你的账号分组和后台渠道配置。常见分组可能包含普通线路、高级线路、Claude 线路、Azure/OpenAI 线路等。
- 如果模型广场能看到模型，但调用失败，检查令牌分组权限。
- 如果模型名拼错，接口会返回模型不可用或请求失败。
- 如果某条上游暂时异常，可以换同类模型或稍后重试。
常见错误排查
| 错误 | 原因 | 处理方式 |
|---|---|---|
| 401 Invalid token | Key 错误、Key 已删除或没有带 Authorization Header | 重新复制令牌，确认格式是 Bearer sk-... |
| 404 Invalid URL | 请求方法或路径不对 | 聊天接口用 POST /v1/chat/completions |
| 模型不存在 | 模型名错误或分组无权限 | 到模型广场确认模型名和分组权限 |
| 余额不足 | 账户额度不足 | 充值、兑换额度或联系管理员 |
| 请求超时 | 上游繁忙或网络波动 | 稍后重试，或切换同类模型/线路 |
安全建议
- 为不同项目创建不同令牌，方便单独限额和删除。
- 给令牌设置额度上限，避免泄露后损失扩大。
- 不要在前端网页、公开仓库、截图、群聊中暴露 API Key。
- 如果发现异常消耗，立即禁用令牌并联系管理员。