Cursor 接入 TimRouter：API Key 与 Base URL

本教程用于 Cursor 的 OpenAI 兼容聊天模型配置。Cursor 的版本、账户或团队设置可能影响可见入口；先验证 API，再验证编辑器中的实际请求。

更新于 2026-10-03。

1. 前置条件与能力范围

安装 Cursor，并在 Cursor Settings → Models查看是否允许使用个人 API Key。
准备 TimRouter Key 与当前分组可用的 OpenAI 兼容聊天模型 ID，核对实时价格。
Cursor 官方说明：自定义 Key 用于聊天模型，Tab 补全继续使用 Cursor 内置模型。第三方 Key 不能据此保证所有 Agent、Composer 或后台功能。
账户权益和团队限制以 Cursor 当前界面与官方说明为准；本页不把某一订阅档位作为保证能接入的条件。

从控制台选择当前分组有权限的模型，复制完整模型 ID。先在当前终端设置 TIMROUTER_API_KEY 和 TIMROUTER_MODEL；下面的示例只读取环境变量，缺少任一项就停止，不会使用默认模型。密钥不要写入代码仓库。

在 Python OpenAI SDK 教程执行一条简短 Chat Completions 请求，确认 Key、模型和 https://api.timrouter.com/v1能返回回复。模型列表成功仅能核对 ID，不能代替推理验收。

配置项	值
API Key	你自己的 TimRouter Key，不使用 OpenAI 官网 Key
Override OpenAI Base URL	`https://api.timrouter.com/v1`
模型 ID	TimRouter 控制台或模型列表中的完整 ID

不要随意给模型 ID 加前缀或制造别名。不同版本可能按模型名称选择提供商；若界面把目标模型发送到另一认证入口，先确认该路由与 TimRouter 支持的协议，无法确认时停止配置并保留报错。

自定义 Key 的模型费用由你的接口提供商计收。Cursor 团队计划还可能有平台用量规则，查看 Cursor 官方 BYOK 计费说明；TimRouter 扣费按计费核账说明核对。

现象	排查方向
找不到 API Keys / Override	检查版本与账户界面；团队成员向管理员核对个人 Key 及提供商权限。
Verify 失败 / 401	确认启用了 Key、保存值完整、Base URL 正确；用 API 单独调用结果判断是否是 Cursor 验证流程问题。
Model not found / 模型名无效	核对完整 ID、Key 分组和 Cursor 实际提供商路由；不要通过任意改名绕过检查。
This model does not support custom API keys	所选模型或功能不接纳自定义 Key，选择当前支持的聊天模型或关闭 override 后使用内置模型。
API 直调成功，Cursor 请求失败	记录 Cursor 版本、报错、时间与请求 ID；检查流式和参数兼容。编辑器请求与最小 API 请求并不相同。
Usage limit / 429	分别核对 Cursor 账户或团队限制，以及 TimRouter Key 额度、余额与速率限制。

设置名称以当前版本界面为准。官方支持资料用于解释配置入口和限制，不保证每个第三方模型都能通过 Cursor 验证。