Cursor

在 Cursor 中使用 678API

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

获取 Cursor

官方客户端

面向开发者的 AI 代码编辑器。安装完成后，可按照本页教程配置 678API 的 Base URL、API Key 和模型。

ProviderOpenAI Compatible

Base URLhttps://www.678api.com/v1

API Key控制台创建的 API Key

Model控制台显示的完整模型 ID

打开模型设置

进入 Cursor Settings，找到 Models、API Keys 或自定义模型供应商区域。不同版本的菜单名称可能略有差异。

添加兼容服务

选择 OpenAI Compatible；如果版本只提供 OpenAI 配置，则使用允许覆盖 Base URL 的入口。

填写地址和密钥

Base URL 填写 https://www.678api.com/v1，API Key 填写在 678API 控制台创建的密钥。

添加模型

从控制台复制完整模型 ID。不要自行删减版本号、短横线或大小写。

启用并测试

保存并启用模型，在 Chat 或 Agent 中发送一条短请求，确认模型能够正常返回。

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

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

建议

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