故障排查

401 Unauthorized

确认使用 Authorization: Bearer ...，并检查密钥是否过期、被轮换或包含多余空格。

找不到模型

重新请求 GET /v1/models，确认目标模型对当前 API Key 可见。不要仅依据网页缓存或旧配置判断。

请求超时

• 为连接和完整响应分别设置合理超时。
• 长文本优先使用流式响应。
• 仅对可安全重放、尚未向用户输出的请求做有限重试。
• 使用指数退避并设置最大重试次数。

流式输出一次性出现

检查客户端和中间反向代理是否缓冲响应。命令行测试可使用 curl -N 关闭输出缓冲。

仍然无法解决

记录请求时间、HTTP 状态码、所用模型和脱敏后的请求 ID。不要提交 API Key、完整用户数据或未经处理的请求日志。