在 Cursor 中使用 Yi-AI Router
通过 Yi-AI Router 连接 Cursor，用一个 API Key 访问所有模型，计费和用量在后台统一管理。
快速开始
前提条件
- 已安装 Cursor
- 已注册 Yi-AI 账户并获取 API Key（
sk-yi-...）
配置步骤
Cursor 通过 Override OpenAI Base URL 功能支持自定义 OpenAI 兼容端点。
步骤 1：打开 Cursor 设置
打开 Cursor Settings（Cmd/Ctrl + ,），进入 Models，展开 API Keys 部分。
步骤 2：配置 OpenAI 提供商
启用 OpenAI API Key，填入以下信息：
| 字段 | 值 |
|---|---|
| OpenAI API Key | 你的 Yi-AI API Key（sk-yi-...） |
| Override OpenAI Base URL | https://www.yiairouter.com/api/v1 |
步骤 3：添加模型
在 Models 部分点击 + Add Model，输入 Yi-AI 模型目录中的模型 ID。例如：
claude-sonnet-4-20250514
claude-haiku-4-5
gpt-4o-mini
gemini-1.5-flash
完整模型列表可在 Yi-AI 控制台 或通过 /api/v1/models 接口查看。
步骤 4：选择模型
在 Cursor 的聊天或 Composer 面板中打开模型选择器，选择已添加的模型。所有请求将通过 Yi-AI Router 路由。
工作原理
Yi-AI Router 实现了 OpenAI Chat Completions API（/api/v1/chat/completions）。Cursor 的 OpenAI 提供商插槽直接与 Yi-AI Router 通信，无需本地代理。平台负责模型映射、用量计费和请求路由。
核心特性：
- 一个 API Key 访问所有厂商模型
- 自动模型路由 — 废弃模型自动降级到稳定替代
- 统一计费 — 所有用量在 Yi-AI 后台追踪
- 无厂商锁定 — 随时切换模型，无需改配置
模型发现
Cursor 可以从 /api/v1/models 接口自动发现可用模型。配置 OpenAI 提供商后，Cursor 可能自动填充模型列表。如果未自动填充，手动添加 Yi-AI 控制台中显示的模型 ID 即可。
常见问题
"Invalid API Key"
确认使用的是 Yi-AI API Key（sk-yi-...），不是 OpenAI 或其他厂商的密钥。
模型列表为空
确认 Yi-AI 账户余额充足。余额不足时部分模型可能不可用。
请求超时
如果使用本地开发服务器（localhost），确认服务已启动。使用生产网关时检查网络连接。
找不到模型
确认模型 ID 与 Yi-AI 模型目录中的 ID 完全一致。模型 ID 区分大小写。