错误码对照

错误码只能告诉你大致方向，真正定位问题还要结合控制台调用日志里的路径、模型名和上游错误。

HTTP 状态码

HTTP 状态常见含义优先处理方式
400请求体格式错误、参数不支持检查 JSON、参数和协议路径
401鉴权失败检查 API Key 是否完整、是否填在正确字段
402余额不足或额度不足充值、提高令牌额度或换测试令牌
403分组、权限或策略限制检查令牌分组和模型权限
404模型或路径不存在检查 Base URL、协议选择和模型名
408请求超时减小请求、换模型或稍后重试
409任务状态冲突图像/视频任务轮询时检查任务状态
413请求体过大减少上下文、压缩图片或拆分输入
422参数语义不合法去掉高级参数，用最小请求测试
429触发限流降低并发、增加退避重试
500网关内部错误查看日志，稍后重试
502上游错误换模型/渠道或稍后重试
503服务不可用稍后重试或切换模型
504上游超时降低输入长度，增加超时

客户端常见提示

提示通常对应处理
Invalid API key401重新复制 Key
No such model404 model确认模型名和分组
Not Found404 path检查 /v1 是否重复
Rate limit exceeded429降低并发
Insufficient quota402查看余额和令牌额度
Unsupported parameter400 / 422删除客户端高级参数

如何看日志

排障时重点看：

  • 请求路径：是否是 /v1/chat/completions、/v1/responses、/v1/messages。
  • 模型名：是否和控制台一致。
  • HTTP 状态码：对应上表。
  • 原始错误：上游返回的具体原因。
  • 消耗：是否已经产生 token 或任务费用。

最小化复现

如果不确定是 Key、模型还是协议问题，先用在线调试台发一条最小请求。开发者可以用：

curl https://www.wanmoapi.com/v1/models \
  -H "Authorization: Bearer $WANMO_API_KEY"

如果 /v1/models 成功，再测试具体接口。

下一步：常见问题排查。