全部教程 /

在 Cursor 中使用 XHuoAPI

Cursor 允许用自己的 API Key 并把 OpenAI 系请求改发到任意 OpenAI 兼容端点。整个配置只有三个字段:API Key、Base URL、模型 ID。

开始之前

先验证一下

curl https://api.xhuoapi.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v3.2","messages":[{"role":"user","content":"ping"}]}'

配置步骤

1

打开设置:macOS 按 Cmd+Shift+J,Windows/Linux 按 Ctrl+Shift+J,进入 Models 页面,找到 API Keys 区块。

2

在 OpenAI API Key 一栏填入 XHuoAPI 的密钥。即使你不用 OpenAI 的模型,Cursor 也用这一栏给被改写的端点做鉴权。

3

勾选 Override OpenAI Base URL,在出现的输入框里填入下面的地址。

https://api.xhuoapi.ai/v1
4

回到 Models 列表,点 Add model 手动添加模型 ID,例如 deepseek-v4-pro,然后在聊天框的模型选择器里选中它。

注意事项

已知限制:Override 打开后,Cursor 会把所有 OpenAI 系请求都发到你的端点,包括从内置选择器选的 Cursor 订阅模型。要用回订阅模型时需暂时关掉 Override。Cursor 团队已确认这是当前行为。
Tab 补全不受影响,它走 Cursor 自己的后端。
Base URL 填到 /v1 为止,不要带 /chat/completions。客户端会自己拼接后面的路径;多写会得到 404。
模型名必须与定价页里的 ID 完全一致(例如 deepseek-v4-pro,不是 DeepSeek V4 Pro)。大小写、连字符都算。

常用模型