docai.cc

看懂报错:谁的问题,怎么判断

把所有 API 报错分成三类:你的问题、中转站的问题、上游的问题。给一张速查表和判断流程。

工具更新 2026-10-28· 真机验证 2026-10-28 by 码农阿风

三类责任

类型 典型错误 判断
你的问题 401、400、404、上下文超限 换站也一样
中转站的问题 令牌无效、无可用渠道、站点 502 换站就好
上游的问题 5xx、529 overloaded、地区限制 所有站都一样

判断流程

报错了
  ↓
换个站点再试
  ↓
还是同样的错 → 你的问题或上游的问题
好了 → 那个站的问题
  ↓
换模型再试
  ↓
好了 → 该模型/渠道的问题
还是错 → 你的请求或账号

速查表

错误码 大概率责任方
401 你(Key)
403 你(权限)或上游(地区)
404 你(模型名)
400 你(参数)
429 中转站(限流)或你(并发)
500/502/503 上游或站点
504 站点网关
529 上游(Anthropic 容量)

一个习惯

报错时先保存完整原文。 包含 request id 的报错,服务商才能查。

我们把常见报错都整理成了独立页面,直接搜错误码就能找到对应的排查路径。