Những gì bạn sẽ xây dựng
Bạn sẽ gửi một yêu cầu văn bản tới routePOST /v1/chat/completions tương thích OpenAI của CometAPI, in ra thông điệp của assistant và giữ nguyên cấu trúc yêu cầu để sẵn sàng dùng cho các ứng dụng đã sử dụng OpenAI SDK.
Khi nào nên dùng trang này
Sử dụng hướng dẫn nhanh này khi một trong các điều sau phù hợp với dự án của bạn:- Bạn đã dùng OpenAI SDK hoặc cấu trúc yêu cầu Chat Completions.
- Bạn muốn chuyển base URL sang CometAPI.
- Bạn muốn gọi một model ID của CometAPI thông qua một route tương thích API OpenAI.
Điều kiện tiên quyết
- Một API key của CometAPI được lưu trong
COMETAPI_KEY - Một model ID văn bản từ trang Models
curl, Python 3.10+ hoặc Node.js 18+
API key, base URL, xác thực
Sử dụng base URL của CometAPI với các client tương thích OpenAI:Ví dụ mã
Sử dụng các tab bên dưới để gửi cùng một yêu cầu Chat Completions bằng cURL, Python và Node.js.Giải thích luồng hoạt động
Tương thích OpenAI nghĩa là ứng dụng của bạn giữ nguyên endpoint Chat Completions, nội dung request body và tên phương thức SDK, đồng thời thay đổi base URL và model ID sang các giá trị của CometAPI. Route này mặc định là đồng bộ. API trả về đối tượng phản hồi hoàn chỉnh trong một HTTP response, và ứng dụng của bạn đọcchoices[0].message.content.
Để nhận đầu ra tăng dần, đặt stream thành true. Phản hồi sẽ trở thành Server-Sent Events và kết thúc bằng data: [DONE]. Hãy dùng streaming cho giao diện chat và các phản hồi dài. Giữ dạng đồng bộ cho các tác vụ nền và các bài kiểm tra đơn giản.
Các tham số phổ biến
Khắc phục sự cố và câu hỏi thường gặp
Đây có phải là OpenAI API không?
Đây có phải là OpenAI API không?
Không. Đây là tuyến API tương thích OpenAI của CometAPI. Bạn sử dụng API key của CometAPI, base URL của CometAPI và model ID của CometAPI.
Yêu cầu trả về 401
Yêu cầu trả về 401
Xác nhận rằng
COMETAPI_KEY được thiết lập trong cùng shell hoặc runtime gửi yêu cầu. Không dán key thật vào các tệp mã nguồn.Không tìm thấy model
Không tìm thấy model
Sử dụng model ID của CometAPI có hỗ trợ yêu cầu văn bản hoặc chat. Kiểm tra trang Models trước khi thử lại.
SDK vẫn gọi OpenAI
SDK vẫn gọi OpenAI
Xác nhận rằng client đặt
base_url trong Python hoặc baseURL trong Node.js thành https://api.cometapi.com/v1.Các bước tiếp theo
- Đọc tài liệu tham chiếu Chat Completions API.
- Cấu hình SDK client trong Sử dụng CometAPI với OpenAI SDKs.
- Liệt kê các model khả dụng với Liệt kê các model CometAPI khả dụng.
- Thêm xử lý retry và rate-limit với Mã lỗi và chiến lược retry.