大家好，我是苏承栈。最近有不少朋友在使用 Cursor 时遇到了自定义 API 连接失败的问题，今天我们就来聊聊这个话题。
首先，别急着怀疑 Cursor
Cursor 自定义 API 失败，其实很多时候不是 Cursor 本身的问题，而是以下几个关键点没处理好：
- Base URL 填错
- API Key 无效
- Model ID 填错
- Key 没有模型权限
- 接口不是标准 OpenAI-compatible
- 中转站返回了 HTML 或非 JSON
- 目标模型不支持当前请求格式
常见问题解析
1. Base URL 最容易填错
很多人填成 https://xxx.com，实际应该是 https://xxx.com/v1。记住，Cursor 会自己拼路径，你只需要填基础地址即可。
2. API Key 能创建，不代表能调用
有些 Key 可能没有余额、没有模型权限，或者被限速。所以，填入后可能会报 401 或 403 错误。
3. model not found 不一定是模型不存在
可能是模型名写错了，或者 Key 没有权限，或者中转站后台没有分配这个模型。
4. 返回格式不标准，Cursor 也会失败
Cursor 希望对方是 OpenAI-compatible API。如果返回的是 HTML 或字段乱七八糟，Cursor 就无法解析。
建议先用 AI API Doctor 测一遍
如果你不想手动 curl，可以用我做的 AI API Doctor 工具。它会帮你检查 Base URL、API Key、Model ID、返回格式等问题。
实用排查顺序
- 确认 Base URL
- 确认 API Key
- 确认 Model ID
- 看错误码
- 看 usage
小结与拓展
Cursor 自定义 API 连接失败，关键在于 API 配置和中转站能力。建议先用 AI API Doctor 测试，再正式使用。如果你有更多问题，欢迎关注「极星编程网」（www.jxgpc.com）了解更多内容。
—— 苏承栈 敬上