API 调用失败排查:503 模型与接口格式 / 401 / 403 / 429
Claude Code、Codex、Cursor、Dify、Cherry Studio、OpenAI SDK 或自研程序调用失败时,先用这一页判断该查 Token、base_url、模型名、日志,还是查余额和充值。
503:模型名或接口格式不匹配
https://api.token-ciyuan.com/v1,文本请求使用 POST /chat/completions。模型名必须取自当前模型页的实际 ID,例如 claude-sonnet-4-6、gemini-2.5-flash 或 glm-5.2。当前接口不支持 /v1/responses。未出现在当前模型页的模型名也不能调用,例如 gpt-5.5。这两种情况不是余额不足,重复充值不会解决问题。
curl https://api.token-ciyuan.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-完整Token" \
-d '{
"model": "claude-sonnet-4-6",
"messages": [{"role": "user", "content": "reply ok"}],
"max_tokens": 16
}'
OpenAI SDK 请使用 client.chat.completions.create(...)。如果你的客户端只能固定调用 /v1/responses,或不能设置模型名,就需要改用支持 Chat Completions 的客户端或切换其 API 模式。
按报错类型快速定位
先检查 Authorization: Bearer sk-完整Token、Token 是否复制完整、是否使用了旧 Key、客户端是否保存成功。
先检查 base_url、请求路径、User-Agent、客户端是否真的走 OpenAI 兼容入口,再看控制台日志。
先降低并发,用短请求验证;如果是特定模型,先换低延迟或备用模型确认链路是否可用。
确认请求使用 /chat/completions,并从当前模型页复制实际模型 ID;未列出的模型不能调用。
确认当前账号、Token 所属账号、钱包余额和充值到账账号一致,再从控制台充值当前账号。
通常说明请求没进到当前账号,先查客户端的 base_url、API Key、环境变量、代理和是否重复拼了 /v1。
确认模型名用的是实际 ID,不是展示名;先用文档或控制台推荐模型跑一个最小请求。
推荐排查顺序
https://api.token-ciyuan.com/v1,不要写成首页、充值页或重复 /v1/v1。/chat/completions,模型名来自当前模型页,再判断余额、并发或客户端兼容性。最小验证请求
curl https://api.token-ciyuan.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-完整Token" \
-d '{
"model": "doubao-seed-2.0-lite",
"messages": [{"role": "user", "content": "reply ok"}],
"max_tokens": 16
}'
如果这个请求在控制台日志里能看到,再把同样的 Token、base_url 和模型名填回 Claude Code、Cursor、Dify 或你的程序里。
什么时候该充值
只有在控制台余额不足、日志明确提示余额不足,或你已经跑通最小请求并准备扩大真实调用时,再进入充值。充值前先确认页面显示的到账账号和当前 Token 所属账号一致。