AI API 返回 401、403、404、429：按顺序排查

先看状态，再看具体错误#

状态码只是入口，不同协议可能返回更具体的错误类型。正文是 HTML 时，检查是否访问了网页、被代理改写或经过了登录跳转，不能直接当 JSON 解析。

用最小请求做对照#

1. 先查询当前 Key 的模型目录。
2. 使用客户端相同的地址、Key 和模型，发一条无附件、无工具的短文本。
3. 目录请求失败，先解决认证和权限；短文本成功后，再逐步加回高级参数。
4. 终端成功、客户端失败，按 客户端清单 比较配置来源。

调用目录不是完整生成测试；短文本也不能证明长上下文、图片或工具能力全部可用。

超时后不要立刻重发#

连接在途中断开，客户端无法据此证明服务端没有受理。尤其图片、视频、工具执行可能存在成本或副作用。已有任务 ID 就续查，没有 ID 则保留原业务号、幂等键和时间，先核对记录。详见 重试与幂等。

提交问题时可以照这个模板#

1
时间与时区：
2
客户端及版本：
3
运行环境：Windows / WSL / Docker / 远端
4
请求路径：只写路径，不附凭据
5
模型与分组：
6
HTTP 状态与脱敏错误：
7
任务 ID 或请求记录编号：
8
已验证的最小请求结果：

通过 联系与交流 找运营方核对。不要提交完整 Key、Cookie、私有素材链接或客户原始数据。

依据：HiKaRi 常见错误。