cursorapikey.com/Hướng dẫn
Cách sử dụng khóa API Cursor với endpoint tùy chỉnh
Cách dùng cài đặt API Cursor với endpoint của bạn: dán khóa, ghi đè URL cơ sở OpenAI và thêm tên mô hình uncensored. Các bước dưới đây mất khoảng năm phút và bao gồm kiểm tra curl bạn có thể chạy trước.
Cập nhật

Điểm chính
- Cursor cho phép bạn ghi đè URL cơ sở OpenAI và khóa, để bất kỳ endpoint nào tương thích OpenAI đều có thể phục vụ yêu cầu.
- Sử dụng URL cơ sở https://api.cursorapikey.com/v1 và ID mô hình
uncensored. - Kiểm tra khóa bằng curl trước khi chạm vào trình chỉnh sửa, để bạn biết lỗi đến từ phía nào.
- Một prompt 20.000 token kèm câu trả lời 1.000 token tốn $0,0035.
Hướng dẫn này bao gồm những gì
Những người tìm kiếm cách sử dụng API Cursor thường muốn nói đến một trong hai điều. Hoặc họ muốn gọi một số dịch vụ Cursor từ mã, hoặc họ muốn trình soạn thảo Cursor gửi các yêu cầu mô hình của nó đến một endpoint do họ chọn. Hướng dẫn này nói về trường hợp thứ hai. Trang web này là một API được lưu trữ độc lập hỗ trợ giao thức chat completions của OpenAI, vì vậy Cursor có thể giao tiếp với nó giống như cách nó giao tiếp với bất kỳ máy chủ kiểu OpenAI nào.
Mô hình đằng sau là một mô hình trọng số mở duy nhất, được chạy bởi một nhà cung cấp độc lập và được tinh chỉnh để trả lời mà không có từ chối nội dung cho mục đích sử dụng người lớn hợp pháp. Nó không phải là mô hình chính thức của Cursor và không phải là bộ định tuyến giữa các nhà cung cấp. Nó chỉ xử lý văn bản. Đối với lập trình, điều này thường là đủ: bạn gửi mã và hướng dẫn, bạn nhận lại mã và lời giải thích.
Bạn cần ba thứ: khóa API, URL cơ sở https://api.cursorapikey.com/v1 và ID mô hình uncensored. Mọi thứ khác chỉ là tìm đúng trường trong trình chỉnh sửa.
Bước 1: lấy khóa và kiểm tra bằng curl
Đăng ký bằng Google hoặc email và mật khẩu, rồi mở trang khóa API. Tài khoản mới có thể nhận $0,50 tín dụng dùng thử chỉ bằng một cú nhấp chuột. Không cần thẻ và hợp lệ trong 7 ngày. Khóa dùng thử giới hạn ở 2 yêu cầu đồng thời và 60 yêu cầu mỗi phút, đủ cho phiên đầu tiên trong trình chỉnh sửa.
Trước khi mở Cursor, hãy xác nhận khóa hoạt động. Chạy lệnh này trong terminal, với khóa của bạn trong biến môi trường:
export API_KEY="paste-your-key-here"
curl https://api.cursorapikey.com/v1/models \
-H "Authorization: Bearer $API_KEY"
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 Python function that reverses a linked list."}
]
}'
Lời gọi đầu tiên liệt kê mô hình. Lời gọi thứ hai trả về một chat completion bình thường. Nếu cả hai đều thành công, mọi lỗi sau đó trong trình soạn thảo là vấn đề cài đặt và không phải vấn đề khóa. Sự phân tách này giúp giảm đáng kể việc đoán mò.
Bước 2: đặt URL cơ sở và khóa trong Cursor
Mở cài đặt của Cursor và đi đến phần mô hình. Tên menu và bố cục thay đổi giữa các bản phát hành, vì vậy hãy coi các nhãn dưới đây là bản đồ và kiểm tra tài liệu chính thức của Cursor nếu có thứ gì đó đã thay đổi.
- Tìm trường cho khóa API OpenAI và dán khóa của bạn từ trang web này.
- Bật tùy chọn ghi đè URL cơ sở của OpenAI và nhập
https://api.cursorapikey.com/v1. Giữ nguyên/v1ở cuối và không thêm/chat/completions; trình khách tự thêm đường dẫn này. - Thêm một mô hình tùy chỉnh và gõ
uncensoredchính xác, viết thường. - Sử dụng nút xác minh hoặc lưu nếu trình soạn thảo cung cấp, sau đó chọn mô hình mới trong bảng trò chuyện.
Gửi một tin nhắn ngắn như "giải thích hàm này" với một tệp đang mở. Câu trả lời truyền phát có nghĩa là tuyến hoạt động từ đầu đến cuối. Cursor gửi yêu cầu, endpoint truyền phát các token trở lại qua SSE và trình soạn thảo hiển thị chúng khi chúng đến.
Hai lưu ý. Một số tính năng trình chỉnh sửa, như tự động hoàn thành inline bằng Tab, có thể chạy trên các mô hình do Cursor kiểm soát và có thể bỏ qua khóa của bạn, vì vậy hãy kiểm tra tính năng nào thực sự sử dụng mô hình tùy chỉnh. Và vì Cursor có thể định tuyến lưu lượng khóa tùy chỉnh qua máy chủ của mình, hãy đọc tài liệu hiện tại nếu bạn cần biết chính xác mã của bạn di chuyển ở đâu. Hướng dẫn nhanh trên trang web này liệt kê mặt API của hợp đồng.
Kiểm tra cùng một endpoint từ mã
Cách dễ nhất để cô lập một vấn đề là gọi endpoint bằng SDK OpenAI chính thức. Nếu điều đó hoạt động, endpoint ổn và mọi vấn đề còn lại nằm trong cấu hình trình soạn thảo.
from openai import OpenAI
client = OpenAI(
api_key="paste-your-key-here",
base_url="https://api.cursorapikey.com/v1",
)
stream = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a terse senior engineer."},
{"role": "user", "content": "Refactor this loop into a list comprehension: out = []\nfor x in xs:\n if x > 0:\n out.append(x * 2)"},
],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="")
Cùng một thứ trong Node:
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.API_KEY,
baseURL: "https://api.cursorapikey.com/v1",
});
const res = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Write a regex that matches ISO 8601 dates." }],
});
console.log(res.choices[0].message.content);
Các phản hồi truyền phát (streaming) bao gồm thông tin sử dụng ở cuối, giúp bạn ghi lại chính xác số token mà một yêu cầu đã dùng. Mỗi phản hồi cũng kèm theo tiêu đề HTTP X-Balance-USD chứa tín dụng còn lại của bạn và X-Request-Id để bạn tham chiếu nếu có gì đó không đúng.
Những gì hoạt động trong quy trình lập trình
API hỗ trợ truyền phát, chế độ JSON và gọi công cụ (tools, tool_choice, tool_calls được truyền phát và kết quả gửi lại dưới dạng role: "tool"). Các cài đặt lấy mẫu như temperature, top_p, stop, seed và các tham số penalty được chuyển tiếp. Cửa sổ ngữ cảnh là 100.000 token, dùng chung cho prompt và kết quả, và max_tokens là tùy chọn.
100.000 token đó là ngân sách hào phóng cho mã. Một tệp nguồn vài trăm dòng chỉ là vài nghìn token, vì vậy bạn có thể bao gồm nhiều tệp cùng với một hướng dẫn dài và vẫn còn chỗ cho câu trả lời. Kích thước yêu cầu tối đa là 8 MB, điều bạn sẽ không đạt được với văn bản.
Một số thói quen khiến mô hình tùy chỉnh dễ chịu trong trình soạn thảo:
- Giữ
temperaturethấp khi chỉnh sửa mã. Các giá trị khoảng 0,2 cho đầu ra ổn định hơn; chỉ tăng nó khi cần tạo ý tưởng. - Chỉ đính kèm các tệp quan trọng. Mọi token bạn gửi đều được tính phí là đầu vào và toàn bộ cuộc hội thoại được gửi lại ở mỗi lượt.
- Yêu cầu diff hoặc hàm đã thay đổi, không phải toàn bộ tệp, khi tệp dài. Token đầu ra đắt hơn token đầu vào.
- Sử dụng mô hình cho các tác vụ mà việc từ chối cản trở, chẳng hạn như viết proof-of-concept khai thác cho phòng thí nghiệm của riêng bạn, phân tích các mẫu phần mềm độc hại bạn được phép nghiên cứu hoặc tạo dữ liệu thử nghiệm mô phỏng nội dung thực tế khó chịu. Tất cả đều phải hợp pháp.
Giới hạn cứng duy nhất đáng lặp lại: không có nội dung tình dục liên quan đến người chưa thành niên, dưới bất kỳ hình thức nào.
Sửa các lỗi thường gặp
| Triệu chứng | Nguyên nhân có thể | Cách khắc phục |
|---|---|---|
| 401 hoặc "khóa không hợp lệ" | Khóa được dán có khoảng trắng hoặc khóa cũ | Sao chép lại từ trang khóa; kiểm tra bằng curl |
| 404 hoặc "không tìm thấy mô hình" | Tên mô hình được gõ khác nhau | Sử dụng uncensored, viết thường, không có hậu tố |
| 404 trên đường dẫn | URL cơ sở bao gồm /chat/completions | Kết thúc URL cơ sở ở /v1 |
429 với concurrency | Quá nhiều yêu cầu cùng một lúc | Chờ các luồng kết thúc; khóa đầy đủ cho phép 8, khóa dùng thử cho phép 2 |
429 với rate_limited | Hơn 300 yêu cầu mỗi phút (60 trên khóa dùng thử) | Giảm tốc độ, hoặc thử lại sau khi tạm dừng |
429 với Retry-After: 5 | Quá tải tạm thời | Hãy thử lại sau năm giây |
Một yêu cầu truyền phát giữ slot đồng thời của nó cho đến khi luồng kết thúc. Nếu bạn bắt đầu nhiều cuộc trò chuyện trong Cursor và để chúng tạo nội dung, bạn có thể đạt giới hạn độ đồng thời trên khóa dùng thử rất nhanh. Các yêu cầu thất bại hoặc bị từ chối không bị tính phí, nên thử lại không tốn thêm chi phí.
Chi phí cho một phiên lập trình
Giá là $0,15 cho mỗi 1M token đầu vào và $0,50 cho mỗi 1M token đầu ra, trả từ tín dụng trả trước không có gói đăng ký. Một yêu cầu trình chỉnh sửa điển hình có một prompt lớn (tệp của bạn) và một câu trả lời ngắn. Lấy 20.000 token đầu vào và 1.000 token đầu ra:
- Đầu vào: 20.000 x $0,15 / 1.000.000 = $0,0030
- Đầu ra: 1.000 x $0,50 / 1.000.000 = $0,0005
- Tổng cộng: $0,0035 mỗi yêu cầu
Với 100 yêu cầu trong một ngày làm việc là $0,35. Tín dụng dùng thử $0,50 bao gồm khoảng 140 yêu cầu như vậy. Sau khi hết dùng thử, bạn có thể nạp tiền với bất kỳ số nguyên nào từ $20 đến $500, với +5% tín dụng bonus từ $50, +10% từ $100 và +15% từ $200. Thanh toán bằng tiền mã hóa (USDT trên TRC20, USDC trên Base). Tín dụng không bao giờ hết hạn, nên khoản nạp bạn dùng chậm không bị lãng phí. Trang giá cả có bảng đầy đủ, và trang về giải pháp thay thế cho Cursor và Copilot giải thích vị trí của dịch vụ này bên cạnh các trình soạn thảo theo gói đăng ký.
Các prompt không được sử dụng để huấn luyện.
Hướng dẫn khác
Hỏi đáp
Điều này có hoạt động với agent Cursor và gọi hàm không?
API hỗ trợ gọi công cụ với tools, tool_choice và tool_calls dạng streaming. Việc một tính năng Cursor cụ thể sử dụng mô hình tùy chỉnh của bạn phụ thuộc vào trình chỉnh sửa, vì vậy hãy kiểm tra từng tính năng sau khi thiết lập.
Tôi phải nhập tên mô hình nào?
Nhập uncensored, viết thường. Đây là ID mô hình duy nhất, và GET /v1/models liệt kê nó.
Đây có phải là API Cursor chính thức không?
Không. Đây là một API tương thích OpenAI độc lập chạy trên một mô hình trọng số mở. Cursor chỉ cho phép bạn trỏ các cài đặt OpenAI của nó vào một endpoint khác.
Tôi có cần thẻ để dùng thử không?
Không. Tín dụng dùng thử $0,50 được nhận chỉ bằng một cú nhấp chuột trên trang khóa API sau khi đăng ký, không cần thẻ và có hiệu lực trong 7 ngày.
Khóa của bạn chỉ cách một biểu mẫu
Tạo tài khoản, sao chép khóa, thay đổi URL cơ sở. Đó là toàn bộ thiết lập.