Khóa API Codex VS Code: Sử dụng Endpoint Tùy chỉnh

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

Các trợ lý lập trình trong VS Code giao tiếp với mô hình qua HTTP. Hầu hết chúng sử dụng định dạng API OpenAI, nghĩa là chúng chấp nhận URL cơ sở và khóa tùy chỉnh thay vì giá trị mặc định của nhà cung cấp. Dịch vụ này tương thích với OpenAI nên có thể tích hợp vào bất kỳ công cụ nào hỗ trợ tùy chọn đó.

Hãy rõ ràng về những gì ở đầu bên kia. Đó là một mô hình trọng số mở do một nhà cung cấp độc lập chạy, được tinh chỉnh để trả lời mà không từ chối nội dung cho người dùng trưởng thành hợp pháp. Nó không phải là mô hình Codex của OpenAI và không phải là API chính thức của bất kỳ nhà cung cấp nào khác. Nó chỉ hỗ trợ văn bản, với cửa sổ 100.000 token, gọi công cụ và chế độ JSON. Nếu bạn muốn biết chi tiết về các tuyến giống OpenAI, hãy đọc tài liệu; nếu bạn chỉ cần địa chỉ, hãy xem trang về Codex API base URL.

Dưới đây là ba giá trị bạn cần sử dụng ở mọi nơi:

Lấy khóa và kiểm tra nó trước

Tạo tài khoản trên trang khóa API bằng Google hoặc bằng email và mật khẩu. Người dùng 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ẻ. Sau đó, hãy kiểm tra khóa trong terminal trước khi chạm vào VS Code. Một lệnh curl hoạt động sẽ chứng minh khóa và URL, vì vậy các lỗi sau đó là do tiện ích mở rộng.

Copy# macOS or Linux, add to ~/.zshrc or ~/.bashrc
export CODEX_API_KEY="YOUR_KEY"

# then verify the endpoint answers
curl https://api.getcodexapi.com/v1/chat/completions \
  -H "Authorization: Bearer $CODEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Write a Python one-liner that reverses a string."}]}'

Phản hồi là JSON hoàn thành trò chuyện, và phản hồi có tiêu đề X-Balance-USD chứa tín dụng còn lại của bạn. Hãy giữ khóa trong biến môi trường hoặc bộ lưu trữ bí mật của tiện ích mở rộng, không bao giờ trong kho lưu trữ mã nguồn.

Tiện ích mở rộng và CLI Codex: tệp cấu hình

Công cụ Codex của OpenAI hỗ trợ các nhà cung cấp mô hình tùy chỉnh thông qua tệp cấu hình TOML trong thư mục home của bạn, và tiện ích mở rộng VS Code được tài liệu hóa để chia sẻ cấu hình đó với CLI. Hãy xác minh điều này với tài liệu Codex hiện tại cho phiên bản của bạn, vì định dạng đã thay đổi.

Copy# ~/.codex/config.toml
model = "uncensored"
model_provider = "custom"

[model_providers.custom]
name = "Custom endpoint"
base_url = "https://api.getcodexapi.com/v1"
env_key = "CODEX_API_KEY"
wire_api = "chat"

Các điểm cần kiểm tra:

• base_url kết thúc bằng /v1, không có /chat/completions.
• env_key là tên của biến môi trường, không phải khóa thực tế.
• wire_api chọn định dạng yêu cầu. Dịch vụ này chấp nhận cả POST /v1/chat/completions và POST /v1/responses. Hãy thử "chat" trước; sử dụng "responses" nếu phiên bản Codex của bạn yêu cầu.
• Khởi động VS Code từ một shell có biến đã được đặt, hoặc khởi động lại nó sau khi bạn thêm biến vào tệp cấu hình shell của mình. Việc khởi chạy GUI trên macOS thường không thấy các biến xuất từ shell.

Các công cụ kiểu agent dựa vào gọi hàm. Nó được hỗ trợ ở đây, bao gồm cả các lệnh gọi hàm theo luồng, nhưng chất lượng thay đổi tùy theo mô hình, vì vậy hãy chạy một nhiệm vụ nhỏ trước. Trang liên quan về cách sử dụng API trong Cursor bao gồm một thiết lập tương tự trong một trình soạn thảo khác.

Continue, Cline và các tiện ích mở rộng khác

Mỗi tiện ích mở rộng bên thứ ba đều có màn hình riêng, nhưng mẫu là không đổi: chọn nhà cung cấp OpenAI hoặc "Tương thích OpenAI", sau đó điền URL cơ sở, khóa và mô hình. Continue sử dụng cấu hình YAML:

Copy# Continue (config.yaml), model entry
models:
  - name: Hosted uncensored
    provider: openai
    model: uncensored
    apiBase: https://api.getcodexapi.com/v1
    apiKey: YOUR_KEY

Cline và Roo Code cung cấp nhà cung cấp "Tương thích OpenAI" trong bảng cài đặt của chúng với ba trường giống nhau. Tên và menu thay đổi thường xuyên, vì vậy hãy tìm kiếm trong tài liệu của tiện ích mở rộng cho "Tương thích OpenAI" hoặc "URL cơ sở tùy chỉnh". Nếu một tiện ích mở rộng không có trường cho URL cơ sở, nó không thể sử dụng endpoint này.

Mẹo tiết kiệm thời gian:

• Tắt tự động hoàn thành đối với mô hình được lưu trữ trừ khi bạn muốn một yêu cầu trong mọi lần tạm dừng. Các hành động trò chuyện và chỉnh sửa rẻ hơn.
• Đặt ngữ cảnh nhỏ hơn trong tiện ích mở rộng cho các chỉnh sửa hàng ngày. Gửi toàn bộ kho lưu trữ cho mô hình tốn token đầu vào mỗi lần.
• Sử dụng một khóa riêng cho mỗi công cụ để bạn có thể biết công cụ nào sử dụng tín dụng của mình.

Nhiệm vụ soạn thảo nào phù hợp với mô hình này

Một mô hình văn bản chung với cửa sổ lớn là một sự phù hợp công bằng cho nhiều công việc hàng ngày: giải thích mã không quen thuộc, viết bài kiểm tra đơn vị cho một hàm, chuyển đổi một tập lệnh giữa các ngôn ngữ, soạn thảo docstrings và regex, và viết lại một mô-đun khi bạn dán toàn bộ tệp. Cửa sổ 100.000 token có nghĩa là một vài tệp trung bình cùng với hướng dẫn của bạn vừa khớp trong một yêu cầu, và phần hoàn thành có thể sử dụng những gì còn lại.

Hãy thực tế về phần còn lại. Nó không phải là một mô hình lập trình chuyên biệt có đào tạo nhận biết trình soạn thảo, vì vậy các chạy agent đa tệp lớn có thể cần nhiều hướng dẫn và kiểm tra hơn bạn sẽ dành cho một công cụ được xây dựng cho chúng. Hãy yêu cầu diff thay vì toàn bộ tệp, xem xét mọi thay đổi trước khi chấp nhận nó và chạy các bài kiểm tra của bạn. Nếu một nhiệm vụ cần nội dung mà trợ lý được kiểm duyệt từ chối, chẳng hạn như viết khung truyện trưởng thành hoặc văn bản nghiên cứu bảo mật cho mục đích hợp pháp, một endpoint không có từ chối nội dung là lý do để sử dụng cái này.

Chi phí khi dùng trong trình chỉnh sửa

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. Các công cụ lập trình gửi rất nhiều ngữ cảnh, vì vậy hãy xem xét đầu vào trước.

Ví dụ: một yêu cầu chỉnh sửa với 8.000 token ngữ cảnh tệp và câu trả lời 600 token tốn 8.000 x $0,15 / 1 triệu + 600 x $0,50 / 1 triệu = $0,0012 + $0,0003 = $0,0015. Một ngày với 150 yêu cầu như vậy tốn 150 x $0,0015 = $0,225. Hai mươi ngày làm việc: $4,50.

Một agent đọc nhiều tệp có thể gửi 40.000 token mỗi bước. Ở kích thước đó, một bước tốn $0,006 cộng với đầu ra, vì vậy 100 bước tốn khoảng $0,60 cộng với đầu ra. Hãy theo dõi các vòng lặp agent. Các yêu cầu thất bại hoặc bị từ chối không bị tính phí và tín dụng không bao giờ hết hạn. Các khoản nạp tiền từ $20 đến $500 có thể được thanh toán bằng thẻ (Visa, Mastercard, Apple Pay, Google Pay) hoặc tiền mã hóa. Các gói hiện có được liệt kê trên trang giá cả.

Khắc phục sự cố

401 Không được ủy quyền

Khóa API bị thiếu, có khoảng trắng thừa hoặc biến môi trường không hiển thị cho VS Code. Khởi động lại trình soạn thảo từ một terminal có biến đó.

404 hoặc "không tìm thấy mô hình"

Sử dụng chính xác mô hình uncensored và URL cơ sở kết thúc bằng /v1.

Lỗi 429

Một khóa đầy đủ cho phép 8 yêu cầu đồng thời và 300 mỗi phút; khóa dùng thử cho phép 2 và 60. Một tiện ích mở rộng bắn ra nhiều yêu cầu đồng thời, chẳng hạn như tự động hoàn thành cộng với trò chuyện, có thể đạt đến giới hạn đồng thời. Mã lỗi là concurrency cho quá nhiều cùng lúc và rate_limited cho giới hạn mỗi phút. Tiêu đề Retry-After: 5 có nghĩa là quá tải tạm thời.

Truyền phát bị treo

Một số proxy doanh nghiệp đệm các sự kiện được gửi bởi máy chủ. Hãy kiểm tra từ một mạng khác hoặc tắt truyền phát trong tiện ích mở rộng.

Câu trả lời khác với những gì bạn đã thấy với trợ lý khác

Điều đó là dự kiến. Đây là một mô hình khác với những điểm mạnh riêng. Hãy đưa ra hướng dẫn rõ ràng, cụ thể và kiểm tra nó trên mã từ dự án của riêng bạn.

Hướng dẫn khác

• Codex API trong Python: Gọi LLM Lập trình
• Codex API Base URL: 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