API Codex là gì?
Thuật ngữ codex api thường đề cập đến giao diện được sử dụng bởi các mô hình AI được đào tạo đặc biệt cho việc tạo và hiểu code. Ban đầu được phổ biến bởi OpenAI, khái niệm này đã phát triển thành một tiêu chuẩn rộng hơn nơi các nhà cung cấp khác nhau cung cấp các endpoint tương thích OpenAI. Đối với các agent lập trình AI, điều này có nghĩa là cấu trúc POST /v1/chat/completions nhất quán xử lý các tương tác văn bản vào, văn bản ra.
Dịch vụ của chúng tôi cung cấp một mô hình ngôn ngữ lớn chuyên dụng, không kiểm duyệt được tối ưu hóa cho ngữ cảnh lập trình. Không giống như các proxy relay tổng hợp nhiều nhà cung cấp, chúng tôi chạy một mô hình trọng số mở duy nhất trên các máy chủ GPU của riêng mình. Điều này đảm bảo một endpoint mô hình ổn định, duy nhất với cửa sổ ngữ cảnh 100.000 token, rất quan trọng để xử lý các bộ code lớn mà không bị mất ngữ cảnh.
API không hỗ trợ embedding, tạo hình ảnh, âm thanh hoặc video, cũng như không cung cấp tinh chỉnh. Nó là một công cụ hoàn thiện dựa trên văn bản được thiết kế để tích hợp trực tiếp vào các agent lập trình như Cursor hoặc Claude Code.
Tại sao nên sử dụng mô hình không kiểm duyệt?
Các mô hình lập trình tiêu chuẩn thường áp dụng bộ lọc nội dung có thể can thiệp vào các tác vụ kỹ thuật. Ví dụ, một mô hình có thể từ chối tạo code cho một lỗ hổng bảo mật hoặc chặn cú pháp ngôn ngữ lập trình cụ thể nếu nó giống với một tác phẩm có bản quyền, ngay cả khi trường hợp sử dụng là hợp pháp và kỹ thuật. Một mô hình không kiểm duyệt loại bỏ các lệnh từ chối tùy tiện này, cho phép agent tập trung hoàn toàn vào chất lượng và logic code.
Mô hình của chúng tôi được tinh chỉnh để trả lời mà không từ chối nội dung cho việc sử dụng người lớn hợp pháp. Điều này đặc biệt hữu ích cho các agent lập trình AI cần xử lý các đoạn code đa dạng, tài liệu hoặc các dự án lập trình sáng tạo mà không gặp lỗi 403 Forbidden do chính sách nội dung.
Có một giới hạn nội dung cứng luôn áp dụng: không có nội dung tình dục liên quan đến trẻ vị thành niên. Các yêu cầu thuộc loại đó sẽ bị chặn. Đối với tất cả các chủ đề người lớn hợp pháp, hư cấu hoặc nghiên cứu bảo mật khác, mô hình sẽ cung cấp câu trả lời trực tiếp. Sự ổn định này giảm nhu cầu về logic thử lại trong quy trình của agent, tiết kiệm token và thời gian.
Cấu hình Cursor IDE
Cursor IDE là một trình soạn thảo code dựa trên AI phổ biến dựa trên các endpoint LLM bên ngoài. Để sử dụng API không kiểm duyệt của chúng tôi làm agent lập trình chính của bạn, bạn cần cập nhật base URL trong cài đặt của mình.
Đi đến cài đặt Cursor của bạn và tìm phần cấu hình API. Thay đổi base URL thành https://api.getcodexapi.com/v1. Nhập khóa API của bạn từ trang Lấy khóa API. ID mô hình bạn nên chọn là uncensored.
Cấu hình này đảm bảo rằng tất cả các đề xuất mã và chỉnh sửa được xử lý bởi mô hình chuyên dụng của chúng tôi. Vì Cursor sử dụng định dạng tương thích với OpenAI, không cần middleware bổ sung. Cửa sổ ngữ cảnh 100.000 token cho phép trình soạn thảo duy trì ngữ cảnh qua các tệp lớn hoặc các tác vụ tái cấu trúc đa tệp, vốn là một hạn chế phổ biến ở các mô hình có cửa sổ ngữ cảnh nhỏ hơn.
Sự đánh đổi: Bạn sẽ không có quyền truy cập vào các mô hình độc quyền như GPT-4 hoặc Claude trừ khi bạn chuyển đổi cấu hình thủ công. Tuy nhiên, đối với việc tạo và chỉnh sửa code thuần túy, endpoint không kiểm duyệt này thường cung cấp kết quả nhanh hơn, nhất quán hơn mà không bị gián đoạn bởi chính sách.
Kết nối Claude Code
Claude Code là một agent dòng lệnh do Anthropic phát triển. Trong khi nó thường sử dụng API của Anthropic, nó có thể được cấu hình để sử dụng bất kỳ endpoint tương thích OpenAI nào nếu client hỗ trợ. Điều này làm cho API của chúng tôi trở thành một giải pháp thay thế khả thi cho những người dùng thích hành vi không kiểm duyệt của mô hình của chúng tôi nhưng thích giao diện Claude Code.
Để kết nối, bạn cần đảm bảo client của bạn hỗ trợ các base URL tùy chỉnh. Cập nhật cấu hình để trỏ đến https://api.getcodexapi.com/v1 và đặt mô hình thành uncensored. Bạn cũng sẽ cần cung cấp khóa API của mình.
Cài đặt này hữu ích cho các nhà phát triển muốn có khả năng gọi công cụ mạnh mẽ của một agent lập trình nhưng cần một mô hình không từ chối các mẫu code phức tạp hoặc kỳ lạ. Lưu ý rằng trong khi giao diện vẫn giống nhau, hành vi của mô hình nền sẽ khác với các mô hình Claude tiêu chuẩn. Luôn kiểm tra các quy trình làm việc cụ thể của bạn để đảm bảo mô hình không kiểm duyệt đáp ứng tiêu chuẩn chất lượng code của bạn.
Sử dụng SDK OpenAI
SDK OpenAI cho Python hoặc Node.js được thiết kế để hoạt động với bất kỳ endpoint tương thích OpenAI nào. Bạn có thể chuyển sang API của chúng tôi bằng cách thay đổi base URL và khóa API.
Dưới đây là cách bạn có thể khởi tạo client trong Python:
from openai import OpenAI
client = OpenAI(
base_url="https://api.getcodexapi.com/v1",
api_key="your-api-key"
)
Sau đó, bạn có thể gọi endpoint hoàn thiện trò chuyện như bình thường:
response = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Write a Python function to sort a list."}]
)
Sự đơn giản này cho phép bạn thay thế mô hình nền mà không cần viết lại logic cốt lõi của agent. SDK xử lý việc tuần tự hóa và phân tích phản hồi, vì vậy bạn có thể tập trung vào logic ứng dụng.
Phản hồi truyền phát (streaming) theo thời gian thực
Đối với các agent lập trình cung cấp các đề xuất code theo thời gian thực, truyền phát (streaming) là rất quan trọng. API của chúng tôi hỗ trợ Server-Sent Events (SSE) cho các phản hồi truyền phát (streaming). Điều này cho phép agent hiển thị code khi nó đang được tạo, cải thiện trải nghiệm người dùng.
- Đặt
stream=Truetrong yêu cầu API của bạn. - Đọc luồng từng phần một.
- Cập nhật giao diện người dùng hoặc trình soạn thảo với mỗi phần.
Điều này giảm độ trễ cảm nhận, đặc biệt là đối với các khối code lớn. Vì mô hình của chúng tôi có cửa sổ ngữ cảnh 100.000 token, bạn có thể truyền phát (streaming) các phản hồi bao gồm lượng lớn ngữ cảnh mà không phải lo lắng về việc bị cắt ngắn.
Lưu ý: Truyền phát (streaming) không thay đổi giá hoặc cách tính token. Token được tính dựa trên tổng lượng input và output, bất kể phản hồi có được truyền phát hay trả về trong một khối duy nhất.
Xử lý gọi hàm công cụ
Các tác nhân AI lập trình thường sử dụng gọi hàm để tương tác với các công cụ bên ngoài, chẳng hạn như chạy lệnh terminal hoặc đọc tệp. API của chúng tôi hỗ trợ tính năng này, cho phép bạn xác định lược đồ hàm trong yêu cầu của mình.
- Xác định các hàm của bạn trong tham số
functions. - Mô hình sẽ trả về phản hồi với một đối tượng
function_call. - Tác nhân của bạn thực thi hàm và gửi kết quả trở lại mô hình.
- Mô hình tạo phản hồi tiếp theo dựa trên kết quả đó.
Sự tương tác nhiều lượt này rất quan trọng cho các tác vụ lập trình phức tạp. Ví dụ, một tác nhân có thể cần đọc một tệp, phân tích nó và sau đó tạo bản sửa lỗi. API của chúng tôi xử lý điều này một cách liền mạch, duy trì ngữ cảnh qua nhiều lượt trong giới hạn 100.000 token.
Quản lý giới hạn tốc độ
Để đảm bảo sử dụng công bằng và ổn định, API của chúng tôi áp dụng giới hạn 300 yêu cầu mỗi phút trên mỗi khóa. Kích thước tối đa của thân yêu cầu là 8 MB. Nếu bạn vượt quá các giới hạn này, bạn sẽ nhận được lỗi 429 Too Many Requests.
Thực tiễn tốt nhất:
- Triển khai cơ chế backoff theo cấp số nhân trong logic thử lại của tác nhân.
- Sử dụng truyền phát để giảm số lượng cuộc gọi API cho các phản hồi lớn.
- Theo dõi mức sử dụng của bạn qua bảng điều khiển để tránh các khoản phí không mong muốn.
Nếu bạn cần xoay khóa, bạn có thể tạo lại khóa API của mình bất cứ lúc nào. Điều này sẽ thu hồi khóa cũ, vì vậy hãy đảm bảo cập nhật các tác nhân của bạn trước khi tạo lại.
