OpenAI 兼容客户端

Cursor / Cherry Studio 配置 1A1API

两个工具的界面入口不同，下面分别说明。共同点是选择 OpenAI Compatible / 自定义 OpenAI，并填写接口根地址（Base URL）、API 密钥和模型 ID。

适用版本：当前 OpenAI 兼容配置入口；界面字段名可能随版本变化 最后验证：2026-07-20

打开 1A1API 控制台模型与接口查看错误码排查

选择工具

先进入对应说明

在模型或 API 配置里使用 OpenAI API Key 与 Override / Base URL 字段。查看 Cursor 填写项 →

在模型服务中新增 OpenAI 兼容提供商，再填写密钥、地址和模型。查看 Cherry Studio 填写项 →

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 密钥可用模型列表复制；gpt-5.6-sol 只作为示例。

会话模型保存后在当前会话中明确选择刚添加的模型，再发送测试。

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）；仍超时就缩短输入或换模型。