在 Cursor 中使用 API2CN.COM

在 Cursor 中使用 API2CN.COM

在 Cursor 的模型设置中添加 OpenAI Compatible 服务，将 Base URL、API Key 和模型名指向 API2CN.COM。

📋 准备信息

配置项 推荐填写值
Provider OpenAI Compatible
Base URL [https://api.api2cn.com/v1](https://api.api2cn.com/v1)
API Key API2CN.COM 控制台创建的 API Key
Model 控制台显示的完整模型 ID

🛠️ 配置步骤

  1. 打开模型设置
    进入 Cursor Settings，找到 Models、API Keys 或自定义模型供应商区域。（不同版本的菜单名称可能略有差异）
  2. 添加兼容服务
    选择 OpenAI Compatible；如果版本只提供 OpenAI 配置，则使用允许覆盖 Base URL 的入口。
  3. 填写地址和密钥
  • Base URL：填写 [https://api.api2cn.com/v1](https://api.api2cn.com/v1)
  • API Key：填写在 API2CN.COM 控制台创建的密钥
  1. 添加模型
    从控制台复制完整模型 ID。（注意：请勿自行删减版本号、短横线或修改大小写）
  2. 启用并测试
    保存并启用模型，在 Chat 或 Agent 中发送一条短请求，确认模型能够正常返回。

🔄 账号、内置模型与切换

  • 无需退出 Cursor 账号
    Cursor 登录负责编辑器、配置同步及 Cursor 自带功能，API2CN.COM API Key 只负责对应的自定义模型请求。
  • 并非所有功能都经过 CUN.AI
    Tab Completion 等依赖 Cursor 专用模型的功能，仍可能继续使用 Cursor 自带服务。
  • 切回 Cursor 官方模型
    如果启用了全局 Override OpenAI Base URL，使用官方模型前需先关闭该开关；再次使用 API2CN.COM 时重新开启。
  • 免费版限制
    Cursor 对自定义 API Key 在 Agent 和 Edit 功能上的可用范围可能受当前套餐限制，具体以 Cursor 客户端提示为准。

❓ 常见问题

现象 处理方式
没有 Verify 按钮 部分新版本保存后自动生效。直接选择已添加的模型发送短消息测试，并到 API2CN.COM 控制台用量日志确认请求。
model not found 从控制台重新复制完整模型 ID，并确认当前账户分组拥有该模型的权限。
官方模型也开始报错 关闭 Override OpenAI Base URL 设置后重试；该设置在部分版本中会误影响其他 OpenAI 内置模型。
Network error / TLS 错误 确认地址填写为 [https://api.api2cn.com/v1](https://api.api2cn.com/v1)；然后到 Cursor 的 Network 设置中将 HTTP Compatibility Mode 切换到 HTTP/1.1 再次测试。
配置成功但 Tab 代码补全未走 API2CN.COM 这是 Cursor 的固有机制；自定义 API Key 主要用于 Chat 和支持的模型，Tab Completion 通常继续使用其内置模型。

💡 最佳建议

建议为 Cursor 单独创建一个独立的 API Key，便于后期按客户端查看用量、轮换密钥或单独停用。