API Codex cho Cursor: Kết nối Mô hình Không kiểm duyệt

Những gì bạn đang thiết lập

Cursor là một trình soạn thảo hỗ trợ các nhà cung cấp mô hình tùy chỉnh. Nếu bạn cung cấp cho nó một base URL kiểu OpenAI, một khóa và một tên mô hình, nó sẽ gửi các yêu cầu chat của mình đến đó thay vì nhà cung cấp mặc định. Dịch vụ này sử dụng giao thức đó: POST /v1/chat/completions với xác thực Bearer, cùng với GET /v1/models.

Hai điều cần rõ ràng ngay từ đầu. Đây là một API độc lập chạy một mô hình trọng số mở duy nhất, không phải Codex của OpenAI và không phải là sản phẩm chính thức của Cursor. Và Cursor thay đổi màn hình cài đặt của mình thường xuyên, vì vậy các nhãn bên dưới có thể nằm ở một vị trí hơi khác trong phiên bản của bạn. Ba giá trị không bao giờ thay đổi: base URL, khóa, tên mô hình.

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

Đăng ký trên trang khóa API bằng Google hoặc bằng email và mật khẩu. Tài khoản mới có thể nhận $0,50 tín dụng dùng thử chỉ với một cú nhấp chuột, có hiệu lực trong 7 ngày, không cần thẻ. Điều đó đủ để kiểm tra cài đặt trình soạn thảo.

Trước khi chạm vào Cursor, hãy xác nhận khóa hoạt động. Một lỗi trong trình soạn thảo khó đọc hơn một lỗi trong terminal.

Copycurl https://api.getcodexapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a Python function that reverses a string."}]
  }'

Nếu bạn nhận được phản hồi JSON có mã trong đó, hãy tiếp tục. Nếu bạn nhận được lỗi, hãy khắc phục nó ở đây trước. Các nguyên nhân phổ biến là thiếu ký tự trong khóa hoặc có khoảng trắng được dán ở cuối.

Bước 2: định cấu hình Cursor

1. Mở cài đặt của Cursor và đi đến phần mô hình.
2. Tìm trường cho khóa API OpenAI và dán khóa của bạn từ dịch vụ này.
3. Bật tùy chọn để ghi đè base URL OpenAI và nhập https://api.getcodexapi.com/v1.
4. Thêm một mô hình tùy chỉnh và nhập chính xác tên uncensored.
5. Nhấn nút xác minh nếu có, sau đó mở bảng chat và chọn uncensored từ danh sách mô hình.

Nếu bước xác minh báo cáo thất bại, hãy kiểm tra ba thứ theo thứ tự: base URL kết thúc bằng /v1 mà không có đường dẫn endpoint nào sau nó, khóa đã được dán mà không có khoảng trắng ở cuối và tên mô hình không có chữ viết hoa. Hướng dẫn trên trang tài liệu liệt kê cùng các giá trị với các ví dụ khách hàng bổ sung.

Một điều cần lên kế hoạch: việc ghi đè là một cài đặt, không phải là lựa chọn cho từng mô hình, vì vậy nếu bạn cũng sử dụng khóa OpenAI của mình ở nơi khác trong Cursor, hãy tắt ghi đè trước. Hãy ghi chú những gì bạn đã thay đổi.

Sau khi lưu, hãy hỏi mô hình một câu hỏi lập trình đơn giản trong chat và theo dõi phản hồi. Câu trả lời chậm đầu tiên là bình thường trong khi Cursor xây dựng yêu cầu của nó. Nếu câu trả lời được trả về, bạn đã kết nối và bước tiếp theo là thử nghiệm nó trên công việc thực tế trong kho lưu trữ của riêng bạn.

Những gì sẽ và sẽ không đi qua khóa của bạn

Cursor kết hợp nhiều tính năng. Các yêu cầu chat và chỉnh sửa nội tuyến là những yêu cầu có khả năng sử dụng mô hình tùy chỉnh của bạn nhất sau khi bạn chọn nó. Các tính năng khác, chẳng hạn như tự động hoàn thành tab, trong lịch sử đã sử dụng các mô hình do Cursor tự chạy và các tính năng kiểu tác nhân có thể phụ thuộc vào cách Cursor xử lý các công cụ. Cách trung thực nhất để biết là hãy thử tính năng bạn dựa vào và theo dõi số dư của bạn.

Điều đó rất dễ thực hiện: mọi phản hồi từ API này đều có tiêu đề X-Balance-USD và số dư của bạn có thể được hiển thị trong tài khoản của bạn. Nếu bạn gửi một tin nhắn chat và số dư không thay đổi, yêu cầu đó đã không được gửi đến chúng tôi.

Endpoint này hỗ trợ gọi hàm (tools, tool_choice, truyền phát tool_calls và kết quả dưới dạng role: "tool"), đúng những gì editor agent cần. Truyền phát hoạt động qua server-sent events với stream: true. Cửa sổ ngữ cảnh là 100.000 token, bao gồm cả prompt và kết quả, nên một tệp lớn cùng các tệp lân cận đều vừa trong một yêu cầu.

Tại sao nên sử dụng mô hình không kiểm duyệt trong trình soạn thảo

Hầu hết công việc lập trình không bao giờ gặp phải từ chối. Khi điều đó xảy ra, nó thường là cho các nhiệm vụ hợp pháp có vẻ rủi ro đối với bộ lọc thận trọng: viết một trình quét cổng cho mạng của riêng bạn, phân tích các mẫu malware bạn đang phân tích, tạo dữ liệu kiểm tra bao gồm ngôn ngữ xúc phạm, xây dựng phần mềm phía máy chủ của một ứng dụng đóng vai hoặc bạn đồng hành cho người lớn hoặc tái cấu trúc (refactor) mã xử lý kiểm duyệt nội dung. Mô hình này được tinh chỉnh để trả lời mà không có từ chối nội dung cho việc sử dụng người trưởng thành hợp pháp.

Nó vẫn là một mô hình trọng số mở chung duy nhất, không phải là mô hình mã chuyên dụng và không có gì ở đây hứa hẹn rằng nó vượt trội hơn bất kỳ giải pháp thay thế cụ thể nào trên cơ sở mã của bạn. Hãy chạy các nhiệm vụ của riêng bạn qua nó. Một quy tắc là cố định: không có nội dung tình dục liên quan đến người chưa thành niên và điều đó không thể thay đổi.

Chi phí thực tế

Giá là $0,15 cho mỗi 1 triệu token đầu vào và $0,50 cho mỗi 1 triệu token đầu ra, từ tín dụng trả trước không có đăng ký. Lưu lượng trình soạn thảo là nặng về đầu vào, vì mọi yêu cầu đều gửi lại ngữ cảnh tệp.

Một yêu cầu với 8.000 token đầu vào và 1.000 token đầu ra tốn 8.000 x $0,15 / 1.000.000 = $0,0012 cho đầu vào, cộng 1.000 x $0,50 / 1.000.000 = $0,0005 cho đầu ra, tổng cộng là $0,0017. Nếu bạn thực hiện 150 yêu cầu như vậy trong một ngày bận rộn, đó là 150 x $0,0017 = $0,255, khoảng 26 xu.

Một yêu cầu gửi 40.000 token ngữ cảnh và nhận lại 1.500 token tốn $0,006 + $0,00075 = $0,00675. Nạp tiền bắt đầu từ $20 và tín dụng không bao giờ hết hạn, nên bạn không bị áp lực phải dùng hết. Xem trang giá để biết các gói thưởng, và trang API lập trình để xem tổng quan chung.

Giới hạn tốc độ cho việc sử dụng trình soạn thảo

Một khóa đầy đủ cho phép 8 yêu cầu đồng thời và 300 yêu cầu mỗi phút. Một khóa dùng thử cho phép 2 yêu cầu đồng thời và 60 yêu cầu mỗi phút. Một người gõ trong một trình soạn thảo hiếm khi đạt đến bất kỳ giới hạn nào, nhưng một nhóm chia sẻ một khóa hoặc một tác nhân bắn nhiều yêu cầu đồng thời thì có. Khi bạn vượt quá, API trả về HTTP 429. Mã rate_limited có nghĩa là quá nhiều yêu cầu mỗi phút và concurrency có nghĩa là quá nhiều yêu cầu cùng một lúc. Nếu dịch vụ bị quá tải tạm thời, bạn cũng sẽ thấy 429 với Retry-After: 5.

Một chat được truyền phát giữ slot đồng thời của nó cho đến khi luồng kết thúc. Đối với việc sử dụng chung, hãy cấp cho mỗi nhà phát triển khóa riêng của họ thay vì một khóa cho nhóm.

Danh sách kiểm tra khắc phục sự cố

• Không tìm thấy mô hình. Nhập lại uncensored không có khoảng trắng. Xóa các mô hình tùy chỉnh cũ mà bạn không sử dụng.
• Lỗi xác thực. Sao chép lại khóa. Đảm bảo Cursor không vẫn đang sử dụng khóa từ nhà cung cấp khác.
• Các phản hồi dừng sớm. Kiểm tra xem Cursor có đặt giới hạn đầu ra của riêng nó không. Phía chúng tôi, max_tokens là tùy chọn.
• Không có thay đổi nào trong số dư của bạn. Tính năng bạn đã sử dụng không được định tuyến qua khóa tùy chỉnh của bạn. Hãy thử chat thay thế.
• 429 thường xuyên. Giảm các yêu cầu đồng thời hoặc sử dụng khóa đầy đủ thay vì khóa dùng thử.

Hướng dẫn khác

• Bảng giá API Codex: Mức giá theo token và ví dụ
• Base URL API Codex: Cách định cấu hình máy khách của bạn cho dịch vụ của chúng tôi
• API LLM không kiểm duyệt cho Cursor