接入 Cursor

将 Cursor IDE 的 AI 能力接入 PilotAIHub，统一调用托管模型并治理 Key。

简介

Cursor 是一款 AI 优先的代码编辑器，支持自定义 OpenAI 兼容端点。通过将 Cursor 指向 PilotAIHub 网关，即可在 Cursor 中调用 PilotAIHub 托管的多模型，并享受虚拟 Key 治理、预算控制与调用审计能力。

前置条件

已注册 PilotAIHub 账号并创建至少一个虚拟 Key（见快速入门）。

安装 Cursor

访问 cursor.com 下载并安装 Cursor。支持 macOS / Windows / Linux。

配置 base_url

将 Cursor 的 OpenAI 兼容接口地址指向 PilotAIHub 网关：

配置位置

打开 Cursor → Settings (⌘,) → Models → 展开「OpenAI API Key」→ 勾选「Override OpenAI Base URL」，填入下方的 base_url；在 API Key 字段填入 PilotAIHub 虚拟 Key。保存后在模型选择处填入 model_code。

base_url

https://api.pilotaihub.com

配置 API Key

在 PilotAIHub 控制台创建虚拟 API Key（以 pk- 开头），填入 Cursor 的 API Key / Secret 字段：

api_key

sk-p-xxxxxxxxxxxxxxxx

Key 安全

API Key 是账户凭证，请勿提交到代码仓库或公开分享。Cursor 的配置仅保存在本地，不会上传 PilotAIHub 之外。

选择模型

在 Cursor 的模型选择处填写 PilotAIHub 支持的 model_code，例如 gpt-4o。完整模型列表见控制台「模型」页或模型市场。

验证调用

配置完成后，用以下请求验证连通性。成功时应返回模型回复：

curl 验证

curl https://api.pilotaihub.com/chat/completions \
  -H "Authorization: Bearer sk-p-xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "你好，请用一句话介绍你自己"}
    ]
  }'

期望响应

HTTP 200 + 一条 assistant 角色的回复。若返回 401 请检查 Key 是否正确；若返回 429 请降低请求频率或联系管理员提升限额。

进阶用法

在 Cursor 的 Composer / Chat 中切换不同模型，按需选择速度快或能力强的模型。
可在 PilotAIHub 控制台为 Cursor 单独建一个 Key 并配置较低并发上限，避免占用其他业务额度。
启用 Cursor 的 Tab 自动补全时，建议使用延迟较低的模型以保持体验流畅。

常见问题

模型不在列表中

Cursor 的模型下拉可能预置了固定列表。勾选自定义模型后手动输入 PilotAIHub 的 model_code 即可，无需从下拉选择。

排查

401 → API Key 错误或已禁用，检查 Key 前缀 pk- 与控制台状态
429 → 超出 RPM/TPM 限额，降低请求频率或联系管理员提升
连接超时 → 检查 base_url 是否为 https://api.PilotAIHub.com/v1