先按错误类型缩小范围,避免盲目重试造成额度浪费。
面向:所有 API / 工具配置用户
401 / Unauthorized:检查 key 是否完整、是否复制了空格、是否填错到别的 provider。
403 / Forbidden:检查当前 key 是否有对应模型或线路权限。
404 / model_not_found:检查 model alias 是否拼错,先换 code alias 测试。
429 / rate_limit:停止连续重试,确认套餐额度、并发和上游限流。
timeout:先换 quick/code alias,确认是否是本地网络、代理或上游慢。
TLS / certificate:检查 base_url 是否是 https,是否被本地代理或证书拦截。
invalid_base_url:确认地址末尾路径,不要重复 /v1,也不要缺少兼容路径。
empty response:保存请求时间和工具名,联系人工核对上游日志。
MCP permission denied:收紧路径或权限,不要为了跑通直接开放全盘。
费用异常:立刻停止 deep / 顶级模型调用,把时间、模型、请求次数发给客服核对。