Token Plan 接入报错排查：鉴权失败、模型不支持等

原创

gavin1024

发布于 2026-10-23 17:27:45

640

摘要： Token Plan 接入常见报错对应明确：401 是 URL 或 API Key 配错，20033 是模型 ID 不对或不在套餐内，429 是触发限流，20059 是输入超长，20097 是当月积分用完。按错误码逐项核对接入地址、密钥、模型 ID 三要素，多数问题可自行解决。

接入报错不用猜，Token Plan 每个错误码都指向确定的原因。把精力放在三个最易错的地方——接入地址、API Key、模型 ID，就能解掉绝大多数问题。下面按错误码拆开讲，每个都给出判断依据和具体动作，照着对一遍即可。

401 unauthorized：地址或密钥问题

这是最高频的报错，根因是 URL 或 API Key 配错。逐项核对：

接入地址对不对：OpenAI 协议工具填 https://tokenhub.tencentmaas.com/plan/v3，Anthropic 协议工具（如 Claude Code）填 https://tokenhub.tencentmaas.com/plan/anthropic。协议填反了会鉴权失败；
API Key 对不对：必须是 Token Plan 的密钥，格式 sk-tp-xxx，复制时别带多余空格或换行；
Key 是否仍有效：Token Plan 重置或删除 API Key 后旧 Key 会失效，套餐到期后 Key 也会失效。

命令行工具还要多查一步：API Key 若通过环境变量注入，确认当前终端能读到——改完 shell 配置要新开终端或重新 source。

20033 invalid model：模型 ID 问题

报模型无效，是模型 ID 写错或不在你订阅的套餐内。处理要点：

全小写：Model ID 必须用全小写格式；
在套餐内：通用 Token Plan 和 Hy Token Plan 支持的模型列表不同，填的模型要属于你买的那个套餐。调混元模型得是 Hy 套餐或支持该模型的通用套餐；
名称准确：对照所订阅套餐的可用模型列表逐字核对，别凭记忆拼写。

Claude Code 用户若遇到子代理相关的 Model ... is not supported by TokenPlan、403、500，在 settings.json 的 env 里补一个 CLAUDE_CODE_SUBAGENT_MODEL，值填套餐支持的模型 ID，建议与主模型一致，改完重启生效。

429 rate limit exceeded：触发限流

这是系统负载高触发的限流，不是你配错了。并发速率与套餐档位相关，按 Max > Pro > Standard > Lite 排序。处理方式简单：

重试 1～2 次；
或切换到另一个模型避开热点。

如果长期频繁限流，说明当前档位的并发不够用，可考虑升配到更高档。

20059 input length too long：输入超长

单次输入超过了允许范围。最直接的解法是新建会话——长对话会把历史上下文一起带上，越滚越长，新建会话清空历史即可恢复。平时养成「新任务新会话」的习惯能避免这个问题，顺带还省积分。

20097 month allocated quota exceeded：积分用完

当月订阅额度已耗尽。两个选择：

等到下个订阅月的同一时刻，额度自动重置；
当月升配到更高档，立刻获得更多额度（升配只补差价，API Key 和到期时间不变）。

注意积分不结转，耗尽后不会扣账户余额或其他资源包，只是停到下月恢复。

报错排查速查表

错误码	含义	首要动作
401	鉴权失败	核对接入地址协议、API Key 是否正确有效
20033	模型不支持	用全小写、确认模型在所订阅套餐内
429	触发限流	重试或换模型，长期则升配
20059	输入超长	新建会话清空历史
20097	积分用完	等下月重置或升配

还有一类非报错但要警惕的情况：消耗速度与自己使用明显对不上。个人版 Token Plan 仅一个 API Key、禁止账号共享，若怀疑 Key 泄露被他处占用，立即在控制台重置 API Key（重置后旧 Key 5 分钟内失效，记得把新 Key 更新到所有工具）。需要稳定的 API 批量调用能力，请改用 Token Plan 企业版。