配置 Cursor / Cherry Studio

配置 Cursor / Cherry Studio

在所用客户端中填写 OpenAI 兼容地址、API 密钥和模型 ID。两个工具的设置入口不同,按对应步骤操作。

适用范围:Cursor / Cherry Studio 的 OpenAI 兼容配置入口 内容核对:2026-10-10 客户端实测:本轮未验证当前界面与接入

选择工具

选择正在使用的客户端

Cursor

配置 Cursor

进入 Settings 中的 Models / API Keys 区域;不同版本可能把自定义地址标为 Override OpenAI Base URL 或类似名称。

OpenAI API Key粘贴 1A1API 控制台复制的 sk-... API 密钥。
Override / Base URL填 https://1a1api.top/v1,不要填完整 /chat/completions。
模型 ID从当前 API 密钥可用模型列表复制准确 ID,并确认所选接口支持该模型。
会话模型保存后在当前会话中明确选择刚添加的模型,再发送测试。
Cherry Studio

配置 Cherry Studio

进入设置中的模型服务,新增 OpenAI 兼容或自定义 OpenAI 提供商;不要误选 Anthropic 原生提供商。

提供商(Provider)选择 OpenAI Compatible / 自定义 OpenAI。
API 密钥粘贴 1A1API 控制台复制的 sk-...。
接口根地址(Base URL)填 https://1a1api.top/v1,不要再追加完整接口路径。
模型 ID从当前 API 密钥可用列表复制,保存后在模型列表中启用。
测试

验证当前会话使用的配置

测试提示词
Reply with exactly: ok
如果客户端有回复,但控制台调用日志里没有本次请求,说明它可能没有使用你刚配置的 API 密钥或提供商(Provider)。先回到模型选择菜单,确认当前会话选中的就是 1A1API。
常见错法

配置失败时检查

Base URL 多了 /v1/v1有些客户端会自己拼 /v1。如果报错,尝试按客户端提示改成 root 或只保留一个 /v1。
模型列表为空从控制台或 /v1/models 复制当前 API 密钥可用模型 ID;能否自动拉取取决于客户端实现。
403 Forbidden当前 API 密钥分组可能没有该模型权限,或订阅额度 / 余额不可用。
请求很久没返回长文本或代码任务尽量开启流式输出(stream);仍超时就缩短输入或换模型。