报错与排查

当你调用云桥AI失败时，不要先改一堆代码，先判断问题属于哪一类。

先看这 4 类

1. 401 / 无效令牌

通常与 API Key、请求头、复制格式有关。见 401 无效令牌。

2. 额度不足 / 429

通常与账户余额、限流、请求频率有关。见 额度不足 / 限流。

3. 请求格式错误

通常与接口路径、JSON 结构、模型名或参数有关。见 请求格式错误。

4. 网络错误 / 超时

通常与本机网络、代理、服务端出站、上游波动有关。见 连接超时 / 网络失败。

建议的排查顺序

1. 先记录 HTTP 状态码
2. 再看原始错误信息
3. 判断是鉴权、额度、格式还是网络
4. 用最小请求重试，而不是一上来就改大段代码

最小验证请求

curl https://yunqiaoai.com.cn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <你的 API Key>" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "user", "content": "ping"}
    ]
  }'

如果这条最小请求都不通，先不要排查复杂业务逻辑，先把最底层链路打通。