VI ▾
Lấy khóa API

cursorapikey.com/Hướng dẫn

Lỗi khóa API Cursor: Sửa với endpoint tùy chỉnh

Khi khóa API Cursor không hoạt động, nguyên nhân thường thuộc một trong bốn khả năng: base URL, tên mô hình, chính khóa đó hoặc giới hạn trên tài khoản. Một lệnh curl duy nhất sẽ cho bạn biết nguyên nhân nào.

Cập nhật

Bảng chỉnh sửa mã trống với một khóa phát sáng đang được lắp vào, một chiếc cờ lê và kính lúp ở bên cạnh
Phân nhánh đẳng hướng với các đường dẫn đến trình soạn thảo, máy chủ và terminal, minh họa việc chọn lựa chọn thay thế cho Cursor

Điểm chính

  • Kiểm tra khóa bên ngoài Cursor trước bằng curl; nếu curl hoạt động, vấn đề nằm ở cài đặt Cursor.
  • Base URL phải là https://api.cursorapikey.com/v1 và tên mô hình phải chính xác là uncensored.
  • 401 nghĩa là khóa sai, 404 là URL sai, 429 là giới hạn tốc độ hoặc giới hạn đồng thời, và lỗi mô hình là tên sai.
  • Nhãn menu thay đổi giữa các phiên bản Cursor, vì vậy hãy khớp mục đích của trường thay vì văn bản chính xác.

Bước 1: kiểm tra khóa bên ngoài Cursor

Loại bỏ Cursor ra khỏi phương trình. Nếu một yêu cầu đơn giản hoạt động, khóa và tài khoản của bạn đều ổn và lỗi nằm ở cài đặt trình chỉnh sửa. Nếu nó bị lỗi, thân lỗi sẽ nêu rõ vấn đề.

curl -i https://api.cursorapikey.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Reply with the word ready."}]}'

Cờ -i in ra dòng trạng thái và tiêu đề. Trạng thái 200 với mảng choices có nghĩa là thành công. Tiêu đề X-Balance-USD hiển thị tín dụng còn lại của bạn, đây là thứ đầu tiên bạn cần kiểm tra nếu gặp lỗi xác thực hoặc thanh toán.

Bạn cũng có thể liệt kê các mô hình, điều này xác nhận khóa mà không tốn gì:

curl https://api.cursorapikey.com/v1/models -H "Authorization: Bearer YOUR_KEY" | grep uncensored

Phản hồi nên chứa ID mô hình uncensored.

Bước 2: đặt các trường trong Cursor

Mở cài đặt của Cursor và tìm phần Mô hình. Bạn cần ba giá trị, và một lỗi trong bất kỳ giá trị nào trong số đó sẽ tạo ra một lỗi trông giống như khóa bị hỏng.

  1. Khóa API OpenAI: dán khóa của bạn không có khoảng trắng hoặc ngắt dòng ở hai đầu.
  2. Ghi đè URL cơ sở OpenAI: bật tính năng ghi đè và nhập https://api.cursorapikey.com/v1. Giữ nguyên /v1 và bỏ /chat/completions.
  3. Mô hình tùy chỉnh: thêm một mô hình tên uncensored và bật nó. Vô hiệu hóa các mô hình bạn không sử dụng để Cursor không chọn một mô hình mà endpoint không biết.

Sau khi lưu, hãy sử dụng tùy chọn xác minh nếu phiên bản của bạn có, sau đó chọn uncensored trong menu thả xuống mô hình chat. Một tab chat mới là một bài kiểm tra tốt, vì một tab cũ có thể giữ mô hình nó bắt đầu với. Hướng dẫn từng bước trong cách sử dụng API Cursor hiển thị cùng thiết lập với nhiều ngữ cảnh hơn.

Khớp lỗi với cách khắc phục

Những gì bạn thấyNguyên nhân có khả năng caoCách khắc phục
401, "khóa không hợp lệ", "Không được ủy quyền"Nhập sai khóa, bị cắt ngắn hoặc bị thu hồiSao chép lại từ trang khóa; kiểm tra khoảng trắng cuối
404, "không tìm thấy"URL sai, thiếu /v1, hoặc đường dẫn képSử dụng chính xác https://api.cursorapikey.com/v1
"không tìm thấy mô hình" hoặc tương tựTên mô hình khác với uncensoredThêm mô hình tùy chỉnh với tên chính xác đó, viết thường
429 với rate_limitedVượt quá giới hạn yêu cầu mỗi phútGiảm tốc độ; khóa dùng thử cho phép 60 mỗi phút, khóa đầy đủ cho phép 300
429 với concurrencyQuá nhiều yêu cầu cùng một lúcGiảm số lần chạy agent song song; dùng thử 2, khóa đầy đủ 8
429 với Retry-After: 5Quá tải tạm thờiChờ năm giây và thử lại
Hoạt động trong curl, thất bại trong CursorCài đặt chưa được lưu, mô hình trong tab sai hoặc tính năng không sử dụng khóa tùy chỉnhXem phần tiếp theo

Các yêu cầu bị lỗi hoặc từ chối không bị tính phí, nên thử lại trong khi gỡ lỗi không tốn gì.

Khi curl hoạt động nhưng Cursor vẫn thất bại

Đây là trường hợp khó hiểu nhất và có một vài giải thích thông thường.

Mô hình sai được chọn. Cursor giữ các mô hình tích hợp riêng của nó trong danh sách. Nếu một trong số chúng được chọn, yêu cầu sẽ không đi đến endpoint của bạn. Chọn uncensored rõ ràng trong menu thả xuống của chat hoặc trình soạn thảo bạn đang sử dụng.

Không phải mọi tính năng đều sử dụng khóa của bạn. Các tính năng dựa vào các mô hình riêng của Cursor, chẳng hạn như tự động hoàn thành nội tuyến, có thể tiếp tục sử dụng chúng bất kể khóa bạn thêm. Khóa tùy chỉnh áp dụng ở nơi bạn có thể chọn mô hình, đó là chế độ chat và chỉnh sửa. Kiểm tra tài liệu hiện tại của Cursor, vì điều này thay đổi giữa các bản phát hành.

Độ đồng thời từ chế độ agent. Agent và các quy trình chạy nhiều bước có thể kích hoạt nhiều yêu cầu cùng một lúc. Khóa dùng thử cho phép hai yêu cầu cùng lúc. Nếu lỗi chỉ xuất hiện trong chế độ agent, bạn có thể đang chạm giới hạn concurrency, và khóa đầy đủ nâng giới hạn này lên tám. Một yêu cầu truyền phát giữ khe của nó cho đến khi luồng kết thúc, vì vậy các đầu ra dài chiếm khe lâu hơn.

Gọi công cụ. API hỗ trợ gọi công cụ, với tool_calls được truyền phát và kết quả được trả lại dưới dạng role: "tool". Chất lượng sử dụng công cụ phụ thuộc vào mô hình, vì vậy nếu một lần chạy agent bị treo ở bước công cụ, hãy thử cùng nhiệm vụ trong chat thông thường trước.

Kiểm tra phía tài khoản

Nếu curl trả về lỗi về số dư, khóa của bạn hợp lệ nhưng tín dụng đã hết hoặc thời gian dùng thử đã kết thúc. Thời gian dùng thử là $0,50, có hiệu lực trong 7 ngày, được nhận chỉ với một cú nhấp chuột trên trang khóa API sau khi đăng ký. Sau đó, bạn cần nạp tiền.

Mức nạp là số nguyên từ $20 đến $500, với +5% từ $50, +10% từ $100 và +15% từ $200. Bạn có thể thanh toán bằng tiền mã hóa (USDT trên TRC20, USDC trên Base). Trang giá hiển thị bảng. Nếu bạn chưa có khóa, lấy một khóa ở đây.

Giữ một khóa cho mỗi công cụ. Nếu bạn đã dán khóa vào nhiều trình chỉnh sửa và tập lệnh, giới hạn tốc độ được chia sẻ giữa chúng, điều này có thể trông giống như các lỗi ngẫu nhiên.

Kiểm tra tập lệnh cho trường hợp cứng đầu

Nếu bạn vẫn không tìm thấy nguyên nhân, hãy chạy một tập lệnh ngắn mô phỏng những gì trình chỉnh sửa làm. Nó sử dụng SDK OpenAI, mà các ứng dụng khách kiểu Cursor được mô phỏng theo, và nó in ra đối tượng lỗi chính xác.

from openai import OpenAI, APIStatusError

client = OpenAI(base_url="https://api.cursorapikey.com/v1", api_key="YOUR_KEY")

try:
    r = client.chat.completions.create(
        model="uncensored",
        messages=[{"role": "user", "content": "Write a one-line Python hello world."}],
        stream=True,
    )
    for chunk in r:
        print(chunk.choices[0].delta.content or "", end="")
except APIStatusError as e:
    print(e.status_code, e.response.headers.get("X-Request-Id"))
    print(e.response.text)

Nếu tập lệnh truyền phát văn bản, endpoint, khóa và mô hình đều chính xác, và vấn đề còn lại là cài đặt Cursor. Nếu nó in ra mã trạng thái, hãy sử dụng bảng ở trên. Giữ giá trị X-Request-Id khi bạn liên hệ hỗ trợ, vì nó xác định yêu cầu chính xác. Chi tiết tham số đầy đủ có trên trang tài liệu.

Ngăn nó bị hỏng lại

Một số thói quen ngăn ngừa hầu hết các vấn đề lặp lại. Lưu khóa trong một mục trình quản lý mật khẩu và sao chép từ đó, thay vì từ nhật ký chat hoặc ghi chú nơi ngắt dòng len lỏi vào. Ghi lại ba giá trị (base URL, khóa, tên mô hình) để bạn có thể nhập lại chúng sau khi cập nhật trình chỉnh sửa, vì đôi khi các bản cập nhật đặt lại các ghi đè. Sau mỗi bản cập nhật, hãy gửi một tin nhắn chat ngắn trước khi bắt đầu công việc thực sự.

Theo dõi số dư. Tiêu đề X-Balance-USD được trả về trên mỗi phản hồi, và bạn cũng có thể đọc nó từ GET /v1/balance. Tín dụng không bao giờ hết hạn, vì vậy một khoản nạp tiền nhỏ nằm trong tài khoản không bị lãng phí. Nếu bạn sử dụng khóa từ cả tập lệnh và trình chỉnh sửa, hãy cung cấp cho các công việc batch dài một vòng lặp thử lại chờ năm giây khi gặp 429 và dừng sau một vài lần thử, để tập lệnh không làm cạn kiệt khe độ đồng thời của trình chỉnh sửa của bạn.

Một yêu cầu chat mã hóa với 10.000 token ngữ cảnh tệp và câu trả lời 700 token tốn 10.000 / 1.000.000 x $0,15 = $0,0015 cho đầu vào và 700 / 1.000.000 x $0,50 = $0,00035 cho đầu ra, tổng cộng khoảng $0,00185. Giá là $0,15 cho mỗi 1M token đầu vào và $0,50 cho mỗi 1M token đầu ra. Bài viết về giá API Cursor bao gồm các ước tính hàng tháng.

Nếu yêu cầu bị lỗi là một yêu cầu lớn, hãy nhớ rằng cửa sổ ngữ cảnh: prompt cộng với kết quả phải vừa với 100.000 token, và phần thân yêu cầu được giới hạn ở 8 MB. Đính kèm toàn bộ kho lưu trữ vào một cuộc trò chuyện có thể vượt quá cả hai giới hạn này. Hãy cắt giảm ngữ cảnh chỉ còn các tệp cần thiết và thử lại.

01

Hỏi đáp

Tại sao Cursor báo khóa API của tôi không hợp lệ?

Thường là khóa có khoảng trắng thừa, bị sao chép thiếu, hoặc base URL vẫn trỏ đến dịch vụ khác. Sao chép lại khóa, sau đó xác nhận URL ghi đè là https://api.cursorapikey.com/v1.

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 mà API cung cấp.

Chức năng tự động hoàn thành có dùng khóa của tôi không?

Không nhất thiết. Một số tính năng của Cursor sử dụng các mô hình riêng của Cursor, và khóa tùy chỉnh chủ yếu áp dụng cho chế độ chat và chỉnh sửa nơi bạn chọn mô hình.

Các yêu cầu thất bại có được tính phí không?

Không. Các yêu cầu thất bại hoặc bị từ chối không được tính phí, vì vậy việc thử lại trong khi bạn gỡ lỗi sẽ không tốn gì.

Khóa của bạn chỉ cần điền 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.