面向开发者的快速入门指南
此快速入门指南展示了如何使用标准的 cursor API 密钥将我们的无限制、OpenAI 兼容 API 集成到您的开发工作流中。
前提条件：你的 API 密钥
登录后立即生成您的密钥。访问“获取 API 密钥”页面，通过 Google 或邮箱密码进行身份验证。界面将即时显示您的唯一密钥，无需手机号。请妥善保管此字符串，因为它用于对所有请求进行基础 URL 身份验证。系统将自动为您提供 $0.50 试用额度，若未使用，该额度将在七天后过期。
配置 Cursor 以兼容 OpenAI
将您的客户端指向我们的特定端点以确保正确路由。将基础 URL 设置为 HTTPS://api.keyapicursor.com/v1 并将您的密钥注入授权头。此配置可与任何标准的 OpenAI 兼容 SDK 配合使用，无需修改模型名称。您必须将模型标识符指定为 uncensored 以获取开放权重输出。
发送你的第一次请求
执行简单的补全以验证连接和延迟。使用下面的 curl 命令向聊天补全端点发送基本提示。响应返回一个包含生成文本的 JSON 对象。检查 usage 字段以确认令牌消耗是否符合您的预期。
处理流式响应
在交互式应用中流式传输令牌以降低感知延迟。服务器发送包含部分增量数据的数据块，直到最后一个数据块包含总使用数据。解析这些事件以实时更新您的用户界面。此方法在 Python 和 Node 客户端中工作方式相同。
与 Python 和 Node SDK 集成
通过仅调整 base URL 和 key 参数来复用现有代码库。Python 代码片段展示了与官方客户端库的直接集成。Node 示例遵循相同的模式，适用于 JavaScript 环境。两种方法均开箱即用地支持 JSON 模式和函数调用。
了解速率限制与令牌
监控您的请求量以避免在重度使用期间出现服务中断。系统强制执行每个密钥每分钟 300 次请求的限制。您可以同时运行八个并发请求，请求体限制为 8 MB。401 无效密钥或 402 余额不足等错误不会消耗您的预付费余额。
cURL
curl https://api.keyapicursor.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Fix syntax error in function parseData"}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.keyapicursor.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.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.keyapicursor.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);流式传输
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)常见问题
我如何获取 cursor API 密钥？
前往获取 API 密钥页面，使用 Google 或电子邮件密码登录。您的唯一密钥会立即显示在仪表板上，无需电话验证。
如果我触及速率限制会怎样？
API 返回 429 状态码，表示您已超过每分钟 300 次请求的阈值。稍作等待后再重试，或增加预付费额度以应对持续的流量高峰。
无限制模型支持函数调用吗？
是的，无审查模型支持工具使用和 JSON 模式。您可以在请求中定义函数，并接收适合程序化工作流的结构化 JSON 响应。
