Token Plan 的 API Key 和接入地址怎么获取与填写

摘要： Token Plan 的 API Key 在控制台 Token Plan 页面点生成密钥获取，格式 sk-tp 开头，每主账号仅一个、两套餐共用。接入地址按协议分：OpenAI 协议填 https://tokenhub.tencentmaas.com/plan/v3，Anthropic 协议填 /plan/anthropic。按工具兼容的协议选对地址再填 Key 即可。

接入 Token Plan 要填的就两样：API Key 和接入地址。Key 的规则很明确——一个主账号一个、通用和 Hy 共用；地址则要按工具协议选对，这是最容易出错的地方。填反协议会直接 401。这篇把获取和填写讲透，顺带说清重置 Key 的连锁影响。

API Key 在哪获取

进控制台的大模型服务平台 TokenHub，在 Token Plan 页面（通用或 Hy 任一标签页都行），点「生成密钥」，得到格式为 sk-tp-xxx 的专属 API Key，点复制保存。

关于 Key 的三条硬规则，接入前务必记牢：

• 每主账号仅一个：Token Plan 个人版只支持生成一个 API Key；
• 两套餐共用：通用 Token Plan 与 Hy Token Plan 用同一个 Key，在任一套餐页生成一次即通用；
• 重置即失效：重置 Key 后旧 Key 5 分钟内永久失效，删除则立即失效且不可恢复，所有在用工具会立刻断连。

接入地址按协议选

Token Plan 提供两套接入地址，对应两种接口协议。选哪个取决于你的工具兼容哪种协议：

判断工具用哪种协议的经验法则：Claude Code 这类基于 Anthropic API 的工具用 /plan/anthropic；Cursor、Cline、Codex、Kilo Code、OpenCode、TRAE 这类 OpenAI 兼容工具用 /plan/v3。拿不准时看工具配置项的命名——出现 ANTHROPIC_BASE_URL 就用 Anthropic 地址，出现 OpenAI Base URL / OpenAI Compatible 就用 v3 地址。

填写时填 Base URL 还是完整 URL

这也是个常见困惑。规律是：

• 工具配置项叫 Base URL 的，填不带路径的基础地址（/plan/v3 或 /plan/anthropic）；
• 工具要求填完整接口地址的，填带 /chat/completions 或 /v1/messages 的完整 URL；
• 多数 GUI 工具（Cursor、Cline 等）填 Base URL，命令行或配置文件场景按其文档要求。

填错层级会导致路径拼接出问题，连不上时先确认这一点。

用 cURL 快速验证

填进工具前，先用一条命令确认 Key 和地址能用（替换成你的真实值）：

curl --location 'https://tokenhub.tencentmaas.com/plan/v3/chat/completions' \
--header 'Authorization: Bearer sk-tp-xxxxxxxx' \
--header 'Content-Type: application/json' \
--data '{
  "model": "kimi-k2.7-code",
  "messages": [{"role": "user", "content": "hello"}],
  "stream": false
}'

返回 JSON 应答即说明 Key 和地址都正确。注意鉴权头是 Authorization: Bearer 加你的 Key。

填写出错的排查

个人版 Token Plan 仅一个 API Key、禁止账号共享，也禁止把 Key 用于自动化脚本或应用后端的批量调用。若发现积分异常消耗、怀疑 Key 泄露，立即重置。需要稳定 API 批量能力请用 Token Plan 企业版。

完成本教程还需要什么

• 协议优先判断：先看工具是 OpenAI 还是 Anthropic 兼容，再定用哪个地址。
• 一个 Key 管两套餐：不用为通用和 Hy 分别生成，共用一个即可。
• 重置要同步：换 Key 后记得更新所有工具，否则会批量断连。

查看接入指引与套餐订阅入口，前往腾讯云 Token Plan 页面：https://cloud.tencent.com/act/pro/tokenplan