o文档
工具接入

Cursor 接入

使用自定义 OpenAI API Key 与基础地址连接自定义接口。

准备信息#

准备 API Key 与模型 ID,并确认当前 Cursor 版本允许覆盖 OpenAI 基础地址。

字段填写内容
OpenAI API Keysk-你的Key
Override OpenAI Base URLhttps://api.onewonconnect.com/v1
Model ID控制台中可用的完整模型名

配置 API Key#

  1. 打开 Cursor Settings → Models 或 API Keys 页面。
  2. 在 OpenAI API Key 配置中填写 API Key,启用对应开关。
  3. 打开 Override OpenAI Base URL,填写下方地址,再保存或 Verify。
Base URL
https://api.onewonconnect.com/v1

若当前版本或组织策略未提供自定义 Base URL 配置,仅填 API Key 无法把请求路由到自定义接口。请改用其他支持自定义服务商的客户端。

添加与选择模型#

如果界面支持添加自定义模型,填写控制台中的真实模型 ID,开启后在新对话中明确选中该模型。先测试一条短消息,再尝试编程任务。

验证与能力范围#

保存后,选择 custom 提供商和账号中可用的模型,在 Cursor 中发送一条短消息。然后到 控制台核对使用记录,确认请求使用了预期的 Key。

认证失败时检查 Key;模型错误时核对模型 ID;接口错误时检查协议和最终请求路径。能拉取模型列表不代表工具调用、图片或 Agent 的全部能力都可用。

自带 Key 的作用范围由 Cursor 决定,Tab 补全及某些内置功能可能仍使用 Cursor 服务。Chat 成功并不能保证所有 Agent 功能均由自定义 Key 驱动。

Cursor 官方说明,自带 Key 的请求仍会经过 Cursor 后端进行最终提示词组装,并非客户端直接向网关发送所有请求。

接入文档