GetRouter文档
  • 简体中文

    • Cursor

    Cursor 对自定义 API Key、Base URL 和模型的支持会随版本与账号功能变化。只有当前版本明确提供 OpenAI API Key、Override OpenAI Base URL 和自定义模型时，才应使用本教程。

    配置状态
    • 推荐协议： OpenAI Chat Completions
    • 配置格式核对： 2026-07-15（Cursor 官方文档与当前设置项）
    • 运行验证： 待验证

    1. 打开模型设置

    在 Cursor Settings 中找到 Models 或 API Keys。确认当前版本允许：

    • 输入自定义 OpenAI API Key；
    • 覆盖 OpenAI Base URL；
    • 添加自定义模型名称。

    如果缺少任一项，不要通过系统代理或 Hosts 劫持绕过。

    2. 配置

    OpenAI API Key:          YOUR_API_KEY
Override OpenAI Base URL: https://getrouter.ai/v1
Custom model:             MODEL_ID

    Cursor 设置项可能只把自定义 Key 用于部分功能。补全、内置 Agent、后台索引或其他专属功能不一定经过该 Endpoint。

    3. 验证

    1. 选择刚添加的 MODEL_ID；
    2. 发起一个只读 Chat 请求；
    3. 在使用记录确认是否出现 /v1/chat/completions；
    4. 再测试编辑和 Agent；
    5. 如果某功能没有请求记录，说明它可能没有使用自定义 Provider。

    常见问题

    • Verify 失败： 检查模型是否支持 Chat Completions，以及 URL 是否重复 /v1。
    • 聊天成功但补全不走 GetRouter： Cursor 不保证所有产品功能共用自定义 API。
    • 模型无法添加： 当前版本或账号可能限制自定义模型。
    • Agent 工具失败： 单独验证 Tool Calling，不要只测试普通聊天。