- API Key 是否正确。
/v1/models是否返回目标模型。- 分组是否开启所需能力。
- 客户端协议是否选对。
- 上游渠道是否可用。
快速定位
| 现象 | 优先查看 |
|---|---|
| 401 | 认证与权限 |
| 403 | 认证与权限 |
| 模型不可见 | 模型问题 |
| 图片失败 | 图像生成问题 |
| Claude Code 调不通 | 认证与权限、模型问题 |
排查
常见问题
黑胡子AI便利店 API 常见问题和排查路径。
优先按下面顺序排查：