中文 ▾
获取 API 密钥

cursorapikey.com/指南

Cursor API 密钥无法使用:自定义接口修复

当 Cursor API 密钥无法使用时,原因几乎总是以下四种之一:Base URL、模型名称、密钥本身,或者账户限制。一条 curl 命令即可确定具体原因。

更新于

抽象代码编辑器面板,显示正在插入的发光密钥,旁边放着扳手和放大镜
等轴测分叉图,显示通往编辑器、服务器和终端的路径,说明选择 Cursor 的替代方案

要点

  • 先用 curl 在 Cursor 外部测试密钥;如果 curl 正常,则问题出在 Cursor 设置中。
  • Base URL 必须为 https://api.cursorapikey.com/v1,且模型名称必须精确为 uncensored。
  • 401 表示密钥错误,404 表示 URL 错误,429 表示速率或并发限制,模型错误表示名称错误。
  • 菜单标签在 Cursor 不同版本间会有变化,因此请匹配字段用途而非确切文字。

步骤 1:在 Cursor 之外测试密钥

将 Cursor 排除在外。如果普通请求正常,说明你的密钥和账户没问题,故障在于编辑器设置。如果失败,错误正文会指出问题所在。

curl -i https://api.cursorapikey.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Reply with the word ready."}]}'

-i 标志会打印状态行和头。200 状态且包含 choices 数组表示成功。X-Balance-USD 头显示你的剩余信用额度,这是遇到授权或支付错误时首先要检查的内容。

你也可以列出模型,这可以确认密钥且不会消耗任何额度:

curl https://api.cursorapikey.com/v1/models -H "Authorization: Bearer YOUR_KEY" | grep uncensored

响应应包含模型 ID uncensored。

步骤 2:在 Cursor 中设置字段

打开 Cursor 的设置并找到“模型”部分。你需要三个值,其中任何一个出错都会导致看似密钥损坏的故障。

  1. OpenAI API 密钥:粘贴你的密钥,两端不得包含空格或换行符。
  2. 覆盖 OpenAI Base URL: 开启覆盖并输入 https://api.cursorapikey.com/v1。保留 /v1 并去掉 /chat/completions。
  3. 自定义模型:添加名为 uncensored 的模型并启用它。禁用你不使用的模型,以免 Cursor 选择端点不认识的模型。

保存后,如果您的版本有验证选项,请使用该选项,然后在聊天模型下拉菜单中选择 uncensored。新建一个聊天标签页是很好的测试方式,因为旧标签页可能会保留启动时的模型。如何使用 Cursor API 中的逐步指南展示了具有更多上下文的相同设置。

将错误与修复方法匹配

你看到的内容可能原因修复方法
401,"密钥无效","未授权"密钥输入错误、截断或已撤销从密钥页面再次复制;检查末尾是否有空格
404,"未找到"URL 错误,缺少 /v1,或路径重复精确使用 https://api.cursorapikey.com/v1
"模型未找到" 或类似情况模型名称与 uncensored 不符使用该确切名称(小写)添加自定义模型
429 带有 rate_limited超过每分钟请求数限制请降低频率;试用密钥每分钟允许 60 次请求,完整密钥每分钟 300 次
429 错误对应 concurrency 限制同时请求过多降低并发代理运行数;试用密钥 2,完整密钥 8
429 且 Retry-After: 5临时过载等待五秒后重试
curl 正常,Cursor 失败设置未保存、标签页模型错误,或该功能不使用自定义密钥请参阅下一节

失败或被拒绝的请求不会收费,因此在调试时重试不会产生费用。

当 curl 正常但 Cursor 仍然失败时

这是最令人困惑的情况,通常有几种解释。

选择了错误的模型。 Cursor 会在列表中保留其内置模型。如果选中了其中一个,请求根本不会发送到你的端点。在你使用的聊天或编辑器下拉菜单中明确选择 uncensored。

并非所有功能都使用您的密钥。 依赖 Cursor 自有模型的功能(如行内自动补全)可能会继续使用它们,无论您添加什么密钥。自定义密钥仅在您可以选择模型的地方应用,即聊天和编辑模式。请检查 Cursor 的当前文档,因为这在版本之间会发生变化。

代理模式的并发。 代理和多步运行可以同时发起多个请求。试用密钥允许同时两个。如果错误仅出现在代理模式中,你可能遇到了 concurrency 限制,完整密钥将其提高到八个。流式请求会占用其槽位直到流结束,因此长输出会占用更长时间的槽位。

工具调用。 API 支持工具调用,tool_calls 以流式输出,结果作为 role: "tool" 传回。工具使用的质量取决于模型,因此如果代理运行在工具步骤卡住,请先在普通聊天中尝试同一任务。

检查账户状态

如果 curl 返回关于余额的错误,说明密钥有效但额度为空或试用已结束。试用额度为 $0.50,有效期 7 天,在注册后点击 API 密钥页面即可领取。之后你需要充值。

充值金额为 $20 到 $500 之间的任意整数金额,$50 起加 5%,$100 起加 10%,$200 起加 15%。您可以通过加密货币(TRC20 上的 USDT、Base 上的 USDC)支付。定价页面 显示了表格。如果您还没有密钥,在此获取。

每个工具保留一个密钥。如果你将密钥粘贴到多个编辑器和脚本中,速率限制将在它们之间共享,这看起来像是随机故障。

顽固案例的脚本检查

如果你仍然无法找到原因,运行一个模拟编辑器操作的简短脚本。它使用 OpenAI SDK(Cursor 风格客户端基于此构建),并打印确切的错误对象。

from openai import OpenAI, APIStatusError

client = OpenAI(base_url="https://api.cursorapikey.com/v1", api_key="YOUR_KEY")

try:
    r = client.chat.completions.create(
        model="uncensored",
        messages=[{"role": "user", "content": "Write a one-line Python hello world."}],
        stream=True,
    )
    for chunk in r:
        print(chunk.choices[0].delta.content or "", end="")
except APIStatusError as e:
    print(e.status_code, e.response.headers.get("X-Request-Id"))
    print(e.response.text)

如果脚本流式输出文本,则接口、密钥和模型均正确,剩余问题是 Cursor 设置问题。如果它打印状态码,请使用上面的表格。联系支持时保留 X-Request-Id 值,因为它标识了确切的请求。完整参数详情见 文档页面。

防止再次出现故障

一些习惯可以防止大多数重复问题。将密钥存储在一个密码管理器条目中并从此处复制,而不是从聊天日志或笔记中复制,因为后者容易混入换行符。记下三个值(基础 URL、密钥、模型名称),以便在编辑器更新后重新输入,因为更新有时会重置覆盖设置。每次更新后,在开始实际工作之前发送一条简短的聊天消息。

关注余额。X-Balance-USD 头信息会在每个响应中返回,您也可以从 GET /v1/balance 读取。额度永不过期,因此账户中少量的充值不会浪费。如果您在脚本和编辑器中都使用密钥,请为长批处理任务提供重试循环,在 429 错误时等待五秒并在几次尝试后停止,以免脚本耗尽编辑器的并发槽位。

带有 10,000 token 文件上下文的编码聊天请求和 700 token 的回答,输入成本为 10,000 / 1,000,000 x $0.15 = $0.0015,输出成本为 700 / 1,000,000 x $0.50 = $0.00035,总计约 $0.00185。费率为每 1M 输入 token $0.15,每 1M 输出 token $0.50。Cursor API 定价 文章涵盖了月度估算。

如果失败的请求很大,请记住上下文窗口:提示词加补全必须适合 100,000 token,且请求体上限为 8 MB。将整个仓库附加到聊天中可能会超过这两项限制。仅保留相关文件的上下文并重试。

01

问答

为什么 Cursor 说我的 API 密钥无效?

通常密钥包含多余空格或复制不完整,或者基础 URL 仍指向其他服务。重新复制密钥,然后确认覆盖 URL 为 https://api.cursorapikey.com/v1。

我应该输入哪个模型名称?

输入 uncensored,全部小写。这是 API 提供的唯一模型 ID。

自动补全会使用我的密钥吗?

不一定。部分 Cursor 功能使用 Cursor 自己的模型,你的密钥主要适用于你选择模型的聊天和编辑模式。

失败的请求会收费吗?

不会。失败或被拒绝的请求不会收费,因此在调试时重试不会产生费用。

只差一张表单,即可获得密钥

创建账户,复制密钥,更改基础 URL。这就是全部设置。