错误与稳定性

401：认证失败

检查 Authorization: Bearer <API_KEY> 是否正确，Key 是否有效。若 Key 用量查询正常但模型调用失败，请保留请求标识，可能需要管理员进一步检查模型服务鉴权。

403：没有权限

检查 Key 的分组、模型范围和 IP 白名单。Key 绑定的分组必须仍属于当前用户，目标模型也必须在授权范围内。

404：接口不存在

通常是 Base URL 或端点路径错误。确认客户端是否自动添加 /v1，并核对接口名称、HTTP 方法和模型能力。

返回 HTML，无法解析 JSON

请求可能到达了网页首页、登录页、反向代理错误页或网络拦截页。检查 API 地址、HTTPS 配置和代理设置，并记录 HTTP 状态码。

5xx：服务异常

使用间隔重试，避免无限循环。如果错误持续，记录时间、模型、端点、状态码和请求标识后联系管理员。

请求超时但后台可能仍在计费吗？

客户端超时不一定意味着服务端已停止处理。不要立即连续重复提交耗时任务；先在调用日志中确认原请求状态，再决定是否重试。

流式响应中途断开怎么办？

检查网络、客户端超时和代理空闲超时。业务程序应保存已接收内容，并仅对幂等或可安全重放的请求进行有限次数重试。

为什么重试后产生了重复内容或重复任务？

生成请求通常不是天然幂等的。客户端在超时后自动重试可能让原请求和新请求同时执行。对于有副作用的任务，应使用业务请求 ID 去重。