Cursor

Cursor 的设置界面和自定义模型能力可能随版本变化。配置目标是让它把 OpenAI Compatible 请求发送到 Sprelay API。

准备

1. 创建名称为 Cursor 的独立密钥。
2. 选择支持目标 OpenAI Compatible 模型的分组。
3. 在模型广场复制模型名称。
4. 更新 Cursor 到支持自定义 OpenAI Base URL 的版本。

配置步骤

1. 打开 Cursor Settings。
2. 进入 Models 或 API Keys 相关设置。
3. 找到 OpenAI API Key，填入 Sprelay 密钥。
4. 启用 Override OpenAI Base URL 或同类选项。
5. 填入 https://sprelaytoken.com/v1。
6. 添加自定义模型，模型 ID 使用模型广场中的完整名称。
7. 保存并执行一次简短聊天或代码解释。

应填写什么

字段	值
OpenAI API Key	sk-your-key 对应的真实密钥
OpenAI Base URL	https://sprelaytoken.com/v1
Model ID	当前分组支持的完整模型名称

常见问题

找不到 Base URL 设置

不同版本或账户方案可能隐藏自定义服务商设置。先查看 Cursor 当前版本说明；无法配置时，不要把密钥填入不相关字段，可改用支持自定义 Provider 的客户端。

模型验证失败

先在终端运行最小请求。终端请求成功而 Cursor 失败时，问题通常在地址自动补全、模型设置或客户端版本。

请求访问了 /v1/v1

客户端若明确说明会自动追加 /v1，则填写 https://sprelaytoken.com。默认先使用 https://sprelaytoken.com/v1，并根据错误日志中的实际请求路径调整。

补全可用但聊天不可用

Cursor 的不同功能可能使用不同模型或协议。逐一检查 Chat、Agent 和补全模型配置，不要假设它们共享同一个模型字段。