Hướng dẫn nhanh cho người dùng Cursor

URL cơ sở và Xác thực

Cấu hình client của bạn trỏ đến https://api.cursorapikey.com/v1. Dịch vụ yêu cầu các tiêu đề xác thực OpenAI tiêu chuẩn. Tạo khóa của bạn trên trang Lấy khóa API; bạn sẽ cần nó cho mọi yêu cầu. Sử dụng ID mô hình uncensored để truy cập mô hình khả dụng duy nhất. Cấu hình này hoạt động với bất kỳ SDK hoặc agent tương thích OpenAI nào như Cursor, Claude Code hoặc các endpoint tùy chỉnh của GitHub Copilot.

Yêu cầu đầu tiên

Kiểm tra kết nối bằng một lệnh hoàn thành trò chuyện đơn giản. Endpoint hỗ trợ các thân yêu cầu tiêu chuẩn. Nếu bạn nhận được trạng thái 200, cấu hình của bạn đã đúng. Lỗi 401 cho biết khóa không hợp lệ hoặc bị thiếu, trong khi lỗi 402 có nghĩa là tín dụng trả trước của bạn đã hết.

Copycurl 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."}]
  }'

Các yêu cầu vượt quá 8 MB hoặc 300 yêu cầu mỗi phút có thể trả về các mã lỗi cụ thể. Xem phần giới hạn tốc độ để biết chi tiết.

Tích hợp SDK Python

Sử dụng thư viện Python OpenAI chính thức. Đặt URL cơ sở và khóa API trong quá trình khởi tạo client của bạn. ID mô hình vẫn là uncensored. Cách tiếp cận này hoạt động cho các tập lệnh cục bộ hoặc tích hợp agent yêu cầu quyền truy cập API theo chương trình. Đảm bảo phiên bản thư viện của bạn hỗ trợ các cấu trúc API OpenAI yêu cầu.

Copyfrom 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)

Hãy nhớ rằng các prompt không được sử dụng để huấn luyện. Ngữ cảnh mã của bạn vẫn riêng tư đối với yêu cầu.

Tích hợp SDK Node

Khởi tạo client OpenAI Node.js với URL cơ sở tùy chỉnh. Truyền khóa API từ các biến môi trường của bạn. ID mô hình uncensored là bắt buộc cho mọi lệnh hoàn thành. Cấu hình này rất lý tưởng cho các agent dựa trên Node hoặc các hàm serverless yêu cầu sự trợ giúp AI nhất quán.

Copyimport 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);

Xác minh thông tin xác thực của bạn trước khi thực hiện các yêu cầu hàng loạt để tránh các lỗi 402 không cần thiết.

Phản hồi truyền phát

Bật truyền phát bằng cách đặt stream: true trong thân yêu cầu của bạn. API trả về các Sự kiện được gửi bởi máy chủ (SSE). Điều này cho phép giao diện người dùng hoặc agent của bạn xử lý các token khi chúng được tạo. Truyền phát giảm độ trễ cảm nhận được cho các phản hồi lớn. Đảm bảo client của bạn xử lý các phần nhỏ một cách chính xác.

Copystream = 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)

Mỗi phần nhỏ chứa nội dung từng phần. Tổng hợp các phần này để tạo thành phản hồi cuối cùng.

Giới hạn, Lỗi và Ngữ cảnh

Cửa sổ ngữ cảnh là 100.000 token cho prompt và phần hoàn thành kết hợp. Giới hạn tốc độ là 300 yêu cầu mỗi phút trên mỗi khóa. Nếu bạn tạo lại khóa, khóa cũ sẽ bị thu hồi ngay lập tức. Lỗi 401 cho biết khóa không hợp lệ. Lỗi 402 cho biết tín dụng không đủ. Lỗi 429 cho biết vượt quá giới hạn tốc độ. Tín dụng không bao giờ hết hạn. Tùy chọn nạp tiền bao gồm tiền điện tử (USDT hoặc USDC).