常见报错码
API 调用失败时，通常会返回一个 HTTP 状态码。你可以先根据状态码判断问题类型，再检查 API Key、Base URL、模型名称、请求参数和账户额度。
大多数调用问题都可以先按这几个方向排查：
- Key 是否正确、
- Base URL 是否为
https://api.maomaotoken.com/v1、 - 模型名称是否写对、
- 账户或令牌额度是否充足。
错误码对照表
| 状态码 | 说明 | 解决方案 |
|---|---|---|
| 400 | 请求格式错误 | 检查请求参数是否符合模型要求，例如部分推理模型可能不支持 system 参数。 |
| 401 | 无效令牌 | 检查 API Key 是否复制完整，是否使用了 MaomaoToken 创建的令牌 Key。 |
| 402 | 余额或套餐额度不足 | 检查账户余额、订阅套餐、令牌额度是否充足。 |
| 403 | 令牌权限或额度受限 | 检查令牌是否被禁用、是否设置了额度限制、模型限制或 IP 限制。 |
| 404 | 接口不存在 | 检查 Base URL 是否正确，建议使用 https://api.maomaotoken.com/v1。 |
| 405 | 请求方法错误 | 检查接口请求方法是否正确，聊天补全接口通常使用 POST。 |
| 408 | 请求超时 | 检查网络连接、请求内容长度和客户端超时时间。 |
| 413 | 请求内容过长 | 缩短 prompt、减少上下文长度或压缩输入内容后重试。 |
| 415 | 请求内容类型错误 | 检查请求头是否设置为 Content-Type: application/json。 |
| 422 | 参数内容不合法 | 检查字段类型、参数范围、模型名称和 messages 内容格式。 |
| 429 | 请求过多或上游限流 | 当前并发或模型流量较高，稍后重试，或切换其他可用模型。 |
| 500 | 服务器内部错误 | 稍后重试；如果持续失败，请保存错误信息并联系客服排查。 |
| 502 | 上游网关错误 | 上游模型或通道临时异常，稍后重试或切换模型。 |
| 503 | 模型暂不可用 | 检查模型名称是否正确，当前分组是否支持该模型。 |
| 504 | 网关超时 | 上游模型未及时响应，稍后重试或切换模型。 |
| 524 | 连接超时 | 通道拥挤或上游响应超时，建议稍后再试。 |
| 529 | 服务过载 | 当前模型负载较高，稍后重试或切换到同类模型。 |
常见问题解答
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/v1请注意不要漏掉 /v1，也不要把其他平台的接口地址和 MaomaoToken 的 Key 混在一起使用。
405 / 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、脚本或服务端项目。