開發者快速入門指南
此快速入門指南展示如何使用標準的 cursor API 金鑰，將我們的 uncensored、OpenAI 相容 API 整合至您的開發工作流程。
前置條件：您的 API 金鑰
登入後立即生成您的金鑰。前往「取得 API 金鑰」頁面，使用 Google 或電子郵件密碼進行驗證。介面將立即顯示您的唯一金鑰，無需手機號碼。請妥善保管此字串，因為它用於驗證對基礎 URL 的所有請求。系統會自動提供 $0.50 試用額度，若未使用則在七天後過期。
為 OpenAI 兼容性配置 Cursor
將您的客戶端指向我們的特定端點以確保正確路由。將基礎 URL 設定為 HTTPS://api.keyapicursor.com/v1，並將您的金鑰注入授權標頭。此設定可與任何標準的 OpenAI-compatible SDK 配合使用，無需修改模型名稱。您必須將模型標識符指定為 uncensored 以獲取開放權重的輸出。
發送您的第一個請求
執行簡單的完成請求以驗證連線與延遲。使用下方的 curl 指令向聊天完成端點發送基本提示。回應將回傳包含生成文字的 JSON 物件。請檢查 usage 欄位，以確認 token 消耗量符合您的預期。
處理串流回應
為互動式應用程式降低感知延遲而串流 token。伺服器發送包含部分增量數據的伺服器發送事件，直到最終區塊包含總使用數據。解析這些事件以即時更新您的使用者介面。此方法在 Python 和 Node 客戶端上以相同方式運作。
與 Python 和 Node SDK 整合
透過僅調整 base URL 和金鑰參數來重用現有程式碼庫。Python 程式碼範例展示了與官方客戶端庫的直接整合。Node 範例遵循相同模式，適用於 JavaScript 環境。兩種方法均原生支援 JSON 模式和函數調用。
了解速率限制與 Token
監控您的請求量以避免在重載期間的服務中斷。系統對每個金鑰實施每分鐘 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 回應。
