跳转到主要内容

​
简短答案

在 Cursor 中配置自定义 OpenAI-compatible API，核心是三项：API Key、Base URL、Model ID。 API Key 用于鉴权，Base URL 决定请求发往哪个 provider，Model ID 决定使用哪个模型。三者必须来自同一个 provider 或兼容网关。

​
什么时候需要它

  • 你想在 Cursor 中使用第三方 OpenAI-compatible provider
  • 你需要填写 Override OpenAI Base URL
  • 你要添加 custom model
  • 你遇到模型不存在或认证失败
  • 你想让 Cursor、Codex 等工具共用同一个模型出口

​
字段说明

字段作用
API Key鉴权凭证
Base URLOpenAI-compatible endpoint，通常是 /v1 地址
Model ID当前 provider 可识别的模型 ID
Custom modelCursor 中手动添加或选择的模型

​
推荐做法

  1. 在 provider 后台创建 API Key。
  2. 在 Cursor 的模型设置中填写 API Key。
  3. 在 Override OpenAI Base URL 中填写 provider 的 Base URL。
  4. 添加或选择当前 provider 支持的 Model ID。
  5. 保存后用一个简单请求验证。

​
常见误区

  • API Key 来自 A provider，Base URL 却填 B provider。
  • 把 Claude 模型名填进 OpenAI-compatible 配置。
  • 使用网页展示名，而不是 API model ID。
  • 以为 Cursor Rules 会影响 API 鉴权。
  • 全局 override 后忘记其他 OpenAI 模型也会受影响。

​
关于 LLMEasy

Cursor 这类外部工具通常走 OpenAI-compatible 接入。LLMEasy 的 Base URL 是 https://www.llmeasy.ru/v1，模型 ID 从模型广场的 GPT 分组复制。 不要把 Claude Code 使用的 https://www.llmeasy.ru 填进 Cursor 的 OpenAI-compatible 配置。

​
References