Cursor 配置 API 中转站：自定义密钥与兼容范围

在 Cursor 中使用星桥，首先要确认当前版本是否提供自定义 OpenAI Base URL，以及目标模型的请求格式是否兼容。能够填写 API Key，不代表该入口可以连接任意第三方网关，也不代表 Tab 补全、Auto 或全部 Agent 功能都可使用这把密钥。

资料核对：2026 年 11 月 1 日。官方 BYOK 文档说明自带密钥的适用范围；下面的自定义地址步骤仅适用于提供该设置的版本。

接入前先做一次最小请求

先在价格页确认密钥的模型与分组，按OpenAI 兼容 API 指南验证最小请求。这样可以区分网关或模型问题与 Cursor 自身设置问题。

提供 Override OpenAI Base URL 的版本

1. 打开 Cursor Settings → Models，找到 API Keys 或对应服务商的密钥设置。
2. 填写星桥 API Key。如果界面提供 Override OpenAI Base URL，启用后填写 https://newapi.xingqiaoapi.cn/v1。
3. 按当前版本的模型管理入口添加并选择实际可调用的模型 ID。
4. 发送一句短消息，再到星桥使用日志核对是否出现对应请求。用明确的模型选择测试，不用 Auto 来推断路由。

若当前版本没有自定义地址入口，仅把星桥密钥填进官方 OpenAI 密钥框不能完成地址配置。不要套用其他平台的专用接口路径；本站没有单独的 /v1/cursor 端点。

自带密钥的功能和数据边界

• Cursor 官方说明自定义密钥适用于聊天模型，Tab 补全继续使用 Cursor 内置模型。
• Cursor 官方说明请求仍经过 Cursor 后端处理；命令行能访问网关，不代表 Cursor 后端同样可以访问。
• 自带密钥不取消 Cursor 产品本身的账户、套餐和功能限制，具体以当前官方规则为准。
• 官方说明其 Zero Data Retention 政策不适用于自带 API Key 的请求；使用前同时核对 Cursor、网关与上游的数据处理说明。

常见问题

填了 API Key 就能使用全部 Cursor 功能吗？

不能。官方自带密钥说明适用于聊天模型，Tab 补全仍用 Cursor 内置模型；Agent、工具调用和第三方网关兼容性需要按版本与模型分别验证。

curl 成功但 Cursor 连接失败，先查什么？

检查当前版本的自定义 Base URL 支持、实际选择的模型、网关收到的请求路径以及 Cursor 后端到网关的连通性。不要反复更换有效密钥来代替检查地址和协议。

参考来源

Cursor 官方：Bring your own API key。需要明确的 CLI 提供商配置时，可阅读Codex CLI 教程；完整客户端说明见星桥接入文档。