Cursor

用 Cursor 的 Override OpenAI Base URL（覆盖 OpenAI base URL）在 Ask 和 Agent 中运行 OneProvider 目录里的 GPT 模型。

Cursor AI 代码编辑器

支持的功能

您添加的 GPT 模型 ID 的 Ask 和 Agent 请求会经过 OneProvider，包括流式的 ApplyPatch 请求。这些请求由 Cursor 自己的服务器发出，所以只有公网端点可用；Cursor 仍然掌控其智能体运行时和专门的托管功能。

客户端限制

需要付费的 Cursor 方案（Pro 或更高）：自 2026 年 1 月起，Cursor 在 Free 方案下会忽略您自己的密钥。覆盖项是全局的——开启期间，除 Anthropic 和 Google 之外的所有模型（包括 Cursor 自己的 GPT、Composer 和 Grok 模型）都会发往 OneProvider，所以要使用 Cursor 自带的模型，请把它关闭。内置的 Anthropic/Claude 和 Google ID 从不使用该覆盖项，Tab 补全和 Cursor 托管的功能仍按原来的方式路由。

设置

1. 更新 Cursor 并准备专用密钥

   在 Pro 或更高方案上使用最新的稳定版 Cursor。创建一个专用的 OneProvider 密钥，限制它的模型和消费，并在验证前为余额充值。

2. 开启 OpenAI API Key

   打开 Cursor Settings → Models → API Keys（Cursor 设置 → 模型 → API 密钥），把专用的 OneProvider 密钥粘贴到 OpenAI API Key 中并打开它的开关——只粘贴密钥并不会启用。

   OpenAI API Key: sk-your-key-here

3. 覆盖 OpenAI base URL

   打开 Override OpenAI Base URL（覆盖 OpenAI base URL），并原样填写 https://api.oneprovider.dev/v1——带 /v1，不带 /chat/completions；路径由 Cursor 自己补上。Cursor 要求使用兼容的 OpenAI 模型 ID；请从模型目录中选择 GPT 文本模型 ID（图像模型无法用于对话）。

   Override OpenAI Base URL: https://api.oneprovider.dev/v1

4. 保存并选择兼容的模型

   保存 OpenAI 密钥和 base URL。如果列表里没有，请把您选好的兼容模型 ID 添加为自定义模型，然后发起一次新的 Ask 或 Agent 请求。Claude 和 Google 的模型 ID 不会经过此覆盖项。想恢复 Cursor 原有的 OpenAI 路由时，关闭该覆盖项即可。

验证连接

在仪表板中确认请求

请求中应显示 gpt-6.1-terra、兼容 OpenAI 的端点、token 用量和实际扣费金额。如果 Cursor 显示的是错误：

"does not work with your current plan or api key" → 使用的是 Free 方案，或 OpenAI API Key 开关是关闭的
"Model name is not valid" → 打开 OpenAI API Key 开关，并新建一个对话
404 / "Invalid URL" → base URL 必须恰好是 https://api.oneprovider.dev/v1
401 → OneProvider 密钥有误、已被撤销或余额不足
"model … is not available" → 该模型 ID 不在 OneProvider 目录中
Cursor 自带的模型无法使用 → 使用它们时请关闭 Override OpenAI Base URL

连接信息

协议

openai-chat

接口地址

https://api.oneprovider.dev/v1

密钥安全

Cursor 通过它自己的服务组装请求，所以不要把密钥限制在您工作站的 IP 上。建议使用专用密钥，并设置模型、速率、消费、有效期和权限范围的限制。

如何选择模型

此覆盖项只支持 OpenAI 风格的模型 ID，因此请选择 GPT 文本模型。gpt-6.1-terra 是 Ask 和 Agent 的均衡默认选择。gpt-6.1-sol 是旗舰档，适合复杂的多文件任务；gpt-5.6-luna 是低成本档，适合快速提问。请把您选好的 ID 按目录 中的写法原样添加为自定义模型。Claude ID 不会经过此覆盖项：要使用 Claude，请在 Cursor 旁边运行 Claude Code 。

常见错误与解决办法

“Model name is not valid”

OpenAI API Key 开关是关闭的，或者模型是在开启开关之前添加的。请打开开关，保存，然后新建一个对话。

“Does not work with your current plan or api key”

您使用的是 Free 方案，或者开关是关闭的。Cursor 在 Free 方案下会忽略您自己的密钥；需要 Pro 或更高方案。

404 或 “Invalid URL”

请原样填写 https://api.oneprovider.dev/v1：带 /v1，不带 /chat/completions。路径由 Cursor 自己补上。

401

密钥有误、已被撤销，或者余额为空。请不带空格地粘贴完整的密钥，并为个人中心充值余额。

开启覆盖项后，Cursor 自带的模型无法使用

覆盖项是全局的：所有非 Anthropic、非 Google 的模型都会发往 OneProvider。要重新使用 Cursor 自带的模型，请关闭 Override OpenAI Base URL。

我的仪表板里没有出现请求

您使用的是 Claude 或 Google 的模型，或者覆盖项已关闭。请选择您添加的 GPT ID，并发起一次新的 Ask 或 Agent 请求。

常见问题

会影响 Tab 补全吗？

不会。Tab 和 Cursor 托管的功能仍按原来的方式路由。

可以把密钥限制在我的 IP 上吗？

不可以。Cursor 从它自己的服务器发出请求，IP 白名单会把这些请求拦住。请改用模型、速率和消费限额。

能通过 OneProvider 在 Cursor 里使用 Claude 模型吗？

无法通过此覆盖项。要使用 Claude，请用 Claude Code 或 Cline 。

怎样切换回去？

关闭 Override OpenAI Base URL。其他设置都会保留。

快速解答

该使用哪个 base URL？

Claude Code 和 Anthropic SDK 使用 https://api.oneprovider.dev。OpenAI SDK 和兼容 OpenAI 的客户端使用 https://api.oneprovider.dev/v1。同一个密钥可用于这两个地址；模型列表见模型页面 ，费率见价格页面 。

如何进行身份验证？

将完整的 sk-… 密钥放在 x-api-key 或 Authorization: Bearer 中，二选一，不要同时使用。请把密钥存放在环境变量中，不要写进会被提交的文件。了解更多身份验证说明 。

在哪里获取密钥？

在 Telegram 机器人 @oneprovider_robot 或 app.oneprovider.dev 打开您的个人中心，为余额充值，然后点击“签发密钥”。每个密钥都可以设置各自的消费限额。个人中心与 API 密钥 。

401、404 和 429 是什么意思？

401：密钥缺失、拼写有误或放错了请求头；请粘贴完整的密钥，不要带引号或空格。404：通常是 base URL 不对，例如缺少或重复了 /v1。429 且提示“Insufficient balance”：个人中心余额或密钥的消费限额已用完，请充值，不要反复重试；其他 429 属于速率限制，请等待 Retry-After 指定的时间。详情见：错误码 和故障排查 。

流式输出为什么会中断或被重置？

VPN 和 VLESS 代理常常会缓冲 SSE，或破坏 HTTP/2 协商。OneProvider 没有地区限制，也不会缓冲流式输出，请关闭代理后重试。

以上都没解决，该去哪里咨询？

请在 Telegram 联系 @Oneproviderhelpbot ，或在网页个人中心打开“客服”，并附上 HTTP 状态码和完整的错误信息。客服如何运作 。