Cursor 用户快速入门
通过更新基础 URL 和认证头,将你的编程工具连接到无审查 API。本快速入门涵盖 Cursor 及其他兼容 OpenAI 代理的基本配置。
基础 URL 与认证
将客户端配置指向 https://api.cursorapikey.com/v1。该服务需要标准的 OpenAI 认证头。在 获取 API 密钥 页面生成密钥;每次请求都需要用到。使用模型 ID uncensored 访问唯一的可用模型。此设置适用于任何兼容 OpenAI 的 SDK 或代理,如 Cursor、Claude Code 或 GitHub Copilot 自定义接口。
首次请求
通过简单的聊天补全测试连通性。该接口支持标准请求体。如果收到 200 状态码,说明配置正确。401 错误表示密钥无效或缺失,402 错误表示预付额度已耗尽。
curl https://api.cursorapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'
请求超过 8 MB 或每分钟超过 300 个请求可能会返回特定的错误代码。请参阅速率限制部分了解详情。
Python SDK 集成
使用官方 OpenAI Python 库。在客户端初始化时设置基础 URL 和 API 密钥。模型 ID 仍为 uncensored。此方法适用于需要程序化 API 访问的本地脚本或代理集成。确保你的库版本支持所需的 OpenAI API 结构。
from openai import OpenAI
client = OpenAI(base_url="https://api.cursorapikey.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)
请记住,提示词不会用于训练。你的代码上下文在请求期间保持私密。
Node SDK 集成
使用自定义基础 URL 初始化 OpenAI Node.js 客户端。从环境变量中传递 API 密钥。所有补全请求都需要模型 ID uncensored。此设置非常适合需要持续 AI 辅助的基于 Node 的代理或无服务器函数。
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.cursorapikey.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);
在进行批量请求之前验证你的凭据,以避免不必要的 402 错误。
流式响应
在请求体中设置 stream: true 以启用流式输出。API 返回 Server-Sent Events (SSE)。这允许你的 UI 或代理在处理过程中接收生成的 token。流式输出可降低大型响应的感知延迟。确保你的客户端能正确处理部分数据块。
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
每个数据块包含部分文本。请聚合这些数据块以形成最终响应。
限制、错误与上下文
上下文窗口为 100,000 token,包含提示词和生成内容。每个密钥的速率限制为每分钟 300 个请求。如果你重新生成密钥,旧密钥将立即失效。401 错误表示密钥无效。402 错误表示额度不足。429 错误表示超出速率限制。额度永不失效。充值选项包括加密货币(USDT 或 USDC)。
接口能力与限制
所有限制、功能与价格一览。
| 项目 | 说明 |
|---|---|
| 接口格式 | 兼容 OpenAI:任何 OpenAI SDK 或客户端只需更换 base URL 和密钥 |
| 模型 ID | uncensored |
| 认证 | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.cursorapikey.com/v1 |
| 接口 | POST /v1/chat/completions · GET /v1/models |
| 采样参数 | temperature、top_p、stop、seed、presence_penalty、frequency_penalty |
| JSON 模式 | response_format: {"type": "json_object"} |
| 最大输出 | 不单独限制输出;提示+回复共 100,000 个 token 窗口内,max_tokens 可选 |
| 上下文窗口 | 100,000 tokens(输入与输出合计) |
| 函数调用 | 支持 tools、tool_choice;回复包含 tool_calls(流式同样支持),结果以 role: tool 消息返回 |
| 流式输出 | 支持 SSE,最后一块包含 token 用量 |
| 请求大小 | 每次请求不超过 8 MB |
| 并发 | 每个密钥同时最多 8 个请求 |
| 速率限制 | 每个密钥每分钟 300 次请求 |
| 响应头 | X-Request-Id、X-Balance-USD、X-RateLimit-Limit-Requests、X-RateLimit-Limit-Concurrency |
| 价格 | 输入 $0.25 / 百万 tokens · 输出 $1.00 / 百万 tokens |
| 免费试用 | $0.50,有效期 7 天,无需银行卡 · 试用密钥:2 个并发请求,每分钟 60 次;首次充值后恢复完整限额(8 和 300) |
| 赠送额度 | 满 $50 送 5%,满 $100 送 10% |
| 额度有效期 | 付费额度永不过期,无订阅 |
| 充值 | USDT(TRC20)或 USDC(Base),$10–$500 任意整数金额 |
| 计费 | 预付额度,按实际 token 用量扣费;错误和拒绝不收费 |
| 登录 | Google 或邮箱 + 密码 |
| 密钥 | 每个账户一个有效密钥;生成新密钥后旧密钥失效 |
| 内容政策 | 允许成人内容;涉及未成年人的性内容一律拒绝 |
错误代码
错误以 JSON 返回,type 字段固定;失败或被拒绝的请求不计费。
| 状态码 | 类型 | 含义 |
|---|---|---|
400 | bad_request | JSON 无效、消息为空、参数错误或超出上下文窗口 |
401 | missing_key · invalid_key · key_revoked | 缺少密钥、密钥错误或已被新密钥替换 |
402 | no_credit | 余额不足——充值后立即恢复 |
403 | content_blocked | 涉及未成年人的性内容——拒绝且不计费 |
404 | not_found | 未知接口 |
413 | request_too_large | 请求体超过 8 MB |
429 | rate_limited · concurrency | 超过每分钟 300 次或 8 个并发——稍后重试 |
503 | upstream_busy | 模型繁忙——几秒后重试 |
问答
这是官方的 Cursor API 吗?
不是,这是一个独立服务。它兼容 OpenAI,可作为 Cursor 等工具中的自定义接口使用。与 Cursor、OpenAI 或 Anthropic 均无关联。
超出速率限制会怎样?
每分钟超过 300 个请求将返回 429 错误。限制按密钥计算。重新生成密钥会撤销旧密钥,但不会重置新密钥的速率限制窗口。
如何为账户充值?
你可以使用加密货币(USDT 或 USDC)充值,最低充值额为 10 美元。提供奖励额度:满 50 美元赠 5%,满 100 美元赠 10%。付费额度永不失效。