本文整理请求已经到达接口后返回的错误。若是 DNS、连接失败、TLS 或超时连接不上，请先看「网络与连接类问题」。

​
503：当前分组没有该模型

在卡特 Token 站中，503 通常表示当前 API Key 所在的令牌分组没有你请求的模型，或该分组不支持当前客户端需要的模型能力。 常见现象： 
503
model_not_found
model not supported
model is not available
当前分组没有该模型
处理方式：
  • 回到卡特 Token 站 API Keys 页面，确认该 Key 选择的令牌分组。
  • 检查客户端配置里使用的模型名称。
  • Claude Code 请选择支持 Claude Code / Claude 兼容模型的分组。
  • Codex 请选择支持 OpenAI 兼容对话 / Codex 的分组。
  • 不要用「GPT生图专用」分组请求 Claude、Codex、GPT 对话或普通聊天模型。
  • 如果需要使用该模型，新建一个支持目标模型的 API Key 后重新配置客户端。
503 不要优先理解为网络问题。先检查“API Key 分组”和“模型名称”是否匹配。

​
400：请求格式或参数不支持

常见现象： 
400 Bad Request
invalid_request_error
invalid model
invalid beta flag
unsupported parameter
常见原因：
  • 客户端发送了当前模型或分组不支持的参数。
  • Claude Code 附加了实验性 beta 请求头，上游不支持。
  • 模型名称写错。
  • Base URL 用错导致协议不匹配。
Claude Code 如果遇到 invalid beta flag，可以临时关闭实验性 beta： 
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1
claude
Windows PowerShell： 
$env:CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS="1"
claude
如果确认有效，再写入 ~/.claude/settings.json 的 env 配置中。

​
413：请求体过大

常见现象： 
413 Request Entity Too Large
request body too large
context length exceeded
通常是当前会话上下文太长，或者一次性粘贴了过大的文件、日志、代码。 处理方式：
  • Claude Code 输入 /compact 压缩上下文。
  • Claude Code 输入 /clear 清空当前会话。
  • Codex 重新开启一个新会话。
  • 分批发送大文件或日志，不要一次性粘贴过多内容。

​
429：请求过快或额度不足

常见现象： 
429
rate_limit_exceeded
No available tokens
insufficient_quota
处理方式取决于具体原因：
错误含义处理
rate_limit_exceeded短时间请求太频繁等待一段时间，降低并发或减少连续请求
No available tokens当前通道可用 token 不足等待恢复或切换支持的分组
insufficient_quota余额或额度不足检查余额并充值
如果是 Codex 或批量任务连续触发 429，先降低并发，不要反复立即重试。

​
500 / 502 / 504：临时服务错误

常见现象： 
500 Internal Server Error
502 Bad Gateway
504 Gateway Timeout
overloaded
upstream error
这类错误通常是临时服务异常、上游返回异常或请求处理时间过长。 处理方式：
  • 稍等后重试。
  • 降低并发。
  • 如果是长上下文任务，先 /compact 或新开会话。
  • 如果持续复现，保留完整报错和时间点联系卡特客服。

​
输出超限

常见现象： 
response exceeded
max output tokens
output token limit
说明单次回复超过客户端或模型允许的输出上限。 处理方式：
  • 让模型分段输出。
  • 要求“先列目录，再逐段生成”。
  • 减少一次请求要求生成的内容量。
  • Claude Code 可按需调整输出 token 相关配置，但不要盲目调到过大。

​
Command timed out

常见现象： 
Command timed out after 2m 0.0s
这通常不是 API 请求错误，而是 Claude Code 执行本地 shell 命令等待超时。 处理方式：
  • 手动复制该命令到终端执行，查看卡在哪一步。
  • 对长时间任务增加命令自身的日志输出。
  • 避免让客户端一次执行没有输出的长命令。

​
排障时提供什么

联系客服时请提供：
  • 客户端：Claude Code、Codex 或其他。
  • API Key 所在令牌分组。
  • 请求模型名称。
  • 完整错误码和错误文本。
  • 发生时间。
  • 是否所有模型都失败，还是只有某个模型失败。
不要发送完整 API Key。