常见报错速查：
| 现象 | 优先检查 | 解决办法 |
|---|---|---|
| 401 / Unauthorized | API Key | 重新复制 Key；不要把“Bearer ”一起填进客户端。 |
| 403 / Forbidden | Key 权限 | 检查余额、状态和模型限制列表。 |
| 404 / Not Found | URL 路径 | Base URL 只到 /v1；完整 URL 才加 /chat/completions。 |
| model_not_found | 模型 ID | 从模型限制列表或 /v1/models 原样复制 model.id。 |
| 能聊天不能 Agent | 工具调用 | 换支持 tool_calls 和 streaming 的模型。 |
| 响应到一半中断 | 流式输出 | 检查 streaming/SSE 兼容性和网络稳定性。 |
| 重复 /v1/v1 | 客户端自动拼接 | 删掉重复路径，只保留一个 /v1。 |
| 超时 | 模型/网络 | 先用小提示词测试，换更快模型，并检查代理或防火墙。 |