故障排查
排障的目标是快速判断问题位于 凭证、协议、模型、路由、网络、客户端还是上游。
标准流程
1. 绕过第三方客户端
bash
curl https://aikey365.com/v1/models \
-H "Authorization: Bearer $AIKEY365_API_KEY"如果这一步失败，先解决 API Key、网络或平台侧问题。
2. 测试目标端点
Chat Completions、Responses、Messages 和 Gemini 是不同协议。使用与你的客户端一致的最小请求。
3. 重新复制模型 ID
不要依赖旧配置、截图或历史教程。
4. 检查 Key 策略
查看 Key 是否：
- 已启用
- 未过期
- 有可用额度
- 允许该模型
- 符合 IP 限制
- 有可用分组和路由候选
5. 查看用量和日志
结合请求时间、模型、状态码和错误文本定位失败记录。
6. 再检查客户端
当 curl 正常而客户端失败时，再看：
- 客户端是否加载旧配置
- Base URL 是否自动拼接
- 环境变量是否来自另一个 Shell
- 代理是否只影响某些进程
- 客户端实际协议是否与你预期一致
提交问题前
准备客户端版本、时间、端点、模型 ID、HTTP 状态码和错误文本。不要发送完整 API Key、密码或敏感业务数据。