常见报错码
API 调用失败时，通常会返回一个 HTTP 状态码。
你可以先根据状态码判断问题类型，再检查 API Key、Base URL、模型名称、请求参数和账户额度，
大多数调用问题都可以先按这几个方向排查：
- Key 是否正确、
- Base URL 是否正确、
- 模型名称是否写对、
- 账户或令牌额度是否充足。
错误码对照表
常见问题解答
400 请求格式错误
400 一般表示请求参数和模型要求不匹配。
可以先检查：
model名称是否正确。messages格式是否正确。- 是否传入了当前模型不支持的字段。
- 如果是推理模型，可以先去掉
system消息测试是否能正常调用。
401 无效令牌
401 通常和 API Key 有关。
请确认你使用的是在 MaomaoToken 控制台创建的令牌 Key，并且没有复制漏字符、多空格或换行。Base URL 建议统一填写：
https://api.maomaotoken.com/v1如果不确定是 Key 的问题还是模型的问题，可以先换一个常用模型测试。
402 余额或套餐额度不足
402 通常表示当前账户余额、订阅套餐或令牌额度不足。
可以进入控制台查看账户余额、套餐使用情况，以及当前令牌是否设置了单独的额度限制。如果只是临时应急，也可以购买短期套餐或补充余额后再试。
403 令牌权限或额度受限
403 常见原因是令牌本身被限制了。
请进入 控制台 👉 API 密钥，检查这个令牌是否设置了额度限制、过期时间、模型限制或 IP 限制。如果只是测试使用，可以新建一个令牌，并先保持默认配置再试。
404 接口不存在
404 大概率是 Base URL 填写不正确。
推荐填写：
https://api.maomaotoken.com/v1405 / 415 请求方式或内容类型错误
405 一般是请求方法不对，例如接口需要 POST，但实际发成了 GET。
415 一般是请求头或请求体格式不对。调用 JSON 接口时，建议确认请求头中包含：
Content-Type: application/json如果你使用的是官方 SDK，这类问题通常较少出现；如果是自己拼接 HTTP 请求，则建议重点检查。
408 / 413 / 422 请求内容问题
408 通常是请求超时，可以检查网络、客户端 timeout 设置，或者减少一次请求携带的上下文。
413 表示请求内容过长，需要缩短 prompt、减少历史消息或压缩输入内容。
422 表示参数能被服务端识别，但内容不符合要求。常见原因包括字段类型不对、参数范围不合法、模型名称写错、messages 格式不正确等。
429 并发受限
429 一般表示请求过多、并发过高，或当前模型通道出现限流。
你可以先稍等一会儿重试，在 Codex 或者 ClaudeCode 中遇到直接打继续任务，正常就能马上恢复。
如果持续出现，可以换一个同类模型测试，或者把模型名称和报错信息发给客服协助排查。
502 / 529 上游异常或服务过载
502 通常表示上游模型或通道临时异常。
529 通常表示当前模型负载过高。遇到这类问题，可以稍后重试，也可以先切换到同类模型继续使用。
503 模型不可用
503 通常和模型名称或当前分组可用渠道有关。
请检查模型名称是否完整，有没有多空格、少字符、大小写错误等问题。模型名称建议以控制台模型列表为准。
如果模型名称确认无误，但仍然持续报错，请将模型名称、调用时间和完整错误信息发给客服处理。
504 / 524 超时
504 和 524 都属于超时类问题，通常表示上游模型响应较慢、通道拥挤，或当前请求内容较长。
可以尝试：
- 缩短 prompt 或减少上下文。
- 稍后重试。
- 切换到响应更快的模型。
- 如果是工具调用场景，适当降低并发请求数量。
还是无法解决？
如果你已经检查过 API Key、Base URL、模型名称、额度和请求参数，仍然无法正常调用，请直接联系我们的客服为您处理。
联系客服时建议一起提供：
- 使用的模型名称。
- 报错状态码和完整错误信息。
- 调用时间。
- 使用场景，例如 Codex、Claude Code、Cursor、脚本或服务端项目。