适用场景
- 401 / 403 / 429 / 超时 / model not found 等排障
- 对比「官方行为」与兼容网关差异
- 整理给服务商的复现材料
推荐模型与消耗
- 推荐模型:
claude-sonnet-4-20250514 - 预估消耗: 约 2k–6k tokens / 次
使用步骤
- 先在本站 检测页 拿到结构化结果(脱敏后)
- 收集:Base URL 的 host、HTTP 状态、延迟、精简响应摘要(不要粘贴完整 Key)
- 使用下方 Prompt 生成假设列表与下一步实验
- 每次只改一个变量复测,避免同时改 Key、模型与 URL
Prompt
你是 API 排障工程师。根据下列观测给出诊断:
输入(已脱敏):
- baseUrlHost:
- status / error:
- latencyMs:
- model:
- 响应摘要(可截断):
- 已尝试操作:
请输出:
1. 最可能根因(按概率排序,最多 3 条)
2. 可立即执行的验证步骤(每步预期现象)
3. 需要向服务商确认的问题清单
4. 与客户端配置相关的检查项(Header、Base URL、模型名)
约束:不要索要完整 API Key;不要假设未提供的日志。
失败排查
| 现象 | 处理 |
|---|---|
| 结论过于发散 | 补上精确状态码与一次成功/失败对照 |
| 误判为「模型不存在」 | 先用检测工具列出/验证可用模型 |
| 间歇超时 | 记录时间段与并发数,区分网络与上游限流 |