在 Cursor 中使用 BeatAPI

Cursor 是一个 AI 代码编辑器。它的模型设置接受 OpenAI 兼容端点，所以填入 BeatAPI 即可，不需要任何插件。

准备工作

1. 已安装 Cursor。
2. 一把 BeatAPI 密钥 —— 在控制台 → API 密钥创建。

第一步：打开模型设置

打开设置 —— 右上角齿轮图标，或 macOS 上按 Cmd+Shift+J、Windows 与 Linux 上按 Ctrl+Shift+J —— 然后在侧栏选择 Models。

第二步：指向 BeatAPI

找到 OpenAI API Key 区域，勾选 Override OpenAI Base URL，然后填写：

保存。Cursor 会先验证端点再接受配置。

第三步：添加你要用的模型

Cursor 自己维护一份模型列表，列表里有不代表你的账户能调。请按编号手工添加下表中的模型，并且只启用这些 —— 账户不提供的模型会在第一次调用时返回 not_found。

Cursor 支持给不同功能配不同模型 —— 对话、行内编辑（Cmd+K）、代码补全。给补全配便宜模型、给对话配强模型，是最能省钱的一招，因为补全触发的次数远高于对话。

第四步：开始使用

• 对话 —— Cmd+L / Ctrl+L，提问或描述任务。
• 行内编辑 —— 选中代码，按 Cmd+K / Ctrl+K，描述要改成什么样。
• 代码补全 —— 正常输入，按 Tab 采纳建议。

用 @文件名 引用文件、@目录名 引用目录，让模型看到该看的上下文，而不是从当前缓冲区猜。

常见问题

Cursor 连不上 BeatAPI

1. Base URL 必须恰好是 https://api.beatapi.io/v1。
2. 密钥必须处于可用状态 —— 在控制台 → API 密钥确认。
3. 若走公司代理，需放行 api.beatapi.io。

列表里的某个模型用不了

那份列表是 Cursor 自己的。只有账户实际提供的编号才会响应，当前目录见价目页。

402 insufficient_credits

余额已用尽，在控制台充值。

429 rate_limit_exceeded

该密钥超出请求频率上限。通常是补全造成的 —— 它几乎每次停顿都会触发。把补全换成便宜模型，或提升额度；每分钟额度随累计充值提升，当前值在控制台可见。

响应很慢

补全和行内编辑用轻量模型，选区尽量小，并优先用 @文件 引用而不是粘贴大段代码。

获取支持

在控制台提交工单，并附上失败响应里的 request_id。