全部教程 /
在 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)。大小写、连字符都算。