Cursor

Cursor 是非常适合接入 FreeDom API 的 IDE 类工具之一。只要它支持自定义模型提供商或兼容 API，就可以直接配置。

一、你需要准备的内容

• 一个可用的 FreeDom API Key
• 平台地址：https://api.yonghu.shop
• 至少一个已开放的可用模型

二、配置思路

在 Cursor 的设置里找到模型提供商、API Key 或 Base URL 相关配置，将默认官方地址替换为你的平台地址。

三、推荐操作步骤

1. 打开 Cursor 设置
2. 找到 Models / Providers / API Keys 相关设置
3. 选择你要接入的 Provider 类型（OpenAI 兼容或 Anthropic 兼容）
4. 将 Base URL 改为：https://api.yonghu.shop
5. 填入你的平台 API Key
6. 选择平台中已开放的模型进行测试

四、推荐测试方法

• 先选一个轻量模型
• 新建一个空文件
• 让 Cursor 做一次最小补全或问答测试

五、常见问题

模型列表为空

可能是：

• 当前 Provider 类型选错了
• 工具不支持自动列模型
• 需要手动输入模型名

401 Unauthorized

API Key 错误或未正确保存。

403 Forbidden

账户额度不足，或当前 Key 没有该模型权限。

六、Cursor 自定义端点注意事项

公开资料和社区反馈里经常提到：Cursor 的 Override OpenAI Base URL 可能会影响当前 OpenAI Provider 下的全部模型，而不是只影响某一个自定义模型。

因此建议：

• 如果你只使用 FreeDom API：可以长期打开自定义 Base URL
• 如果你同时使用 Cursor 官方模型和 FreeDom API：需要根据使用场景切换 Override
• 如果配置后官方模型异常，先关闭 Override 再测试

OpenAI 兼容配置可尝试：

API Key: 你的 FreeDom API Key
Base URL: https://api.yonghu.shop

若工具要求 /v1 结尾，再尝试：

https://api.yonghu.shop/v1

Cursor 配置补充

Cursor 的自定义端点设置随版本变化，配置时请重点找这些字段：

• API Key
• Override OpenAI Base URL / Base URL
• Model Name / Custom Model

推荐先填：

Base URL: https://api.yonghu.shop
API Key: 你的 FreeDom API Key

若请求路径异常，再尝试：

Base URL: https://api.yonghu.shop/v1

验证方式见：接入自测。