Giao thức OpenAI compatible
Kết nối ứng dụng OpenAI compatible bằng Base URL /v1.
Endpoint thường dùng
Trang này liệt kê endpoint OpenAI compatible cho văn bản, Responses, hình ảnh, tác vụ video, âm thanh, vector, moderation và realtime. Tham số video và quy trình polling có hướng dẫn riêng; khả dụng phụ thuộc mô hình và nhóm Key.
Mô hình và khám phá
| Mục đích | Phương thức | Đường dẫn |
|---|---|---|
| Danh sách mô hình | GET | /v1/models |
Văn bản và phản hồi
| Mục đích | Phương thức | Đường dẫn |
|---|---|---|
| Text completion (cũ) | POST | /v1/completions |
| Chat completions | POST | /v1/chat/completions |
| Responses | POST | /v1/responses |
| Nén Responses | POST | /v1/responses/compact |
Hình ảnh
| Mục đích | Phương thức | Đường dẫn |
|---|---|---|
| Tạo hình ảnh | POST | /v1/images/generations |
| Chỉnh sửa hình ảnh | POST | /v1/images/edits |
Tác vụ video
| Mục đích | Phương thức | Đường dẫn |
|---|---|---|
| Tạo tác vụ video | POST | /v1/videos |
| Lấy trạng thái tác vụ video | GET | /v1/videos/{task_id} |
| Lấy nội dung video | GET | /v1/videos/{task_id}/content |
| Tạo tác vụ video (tương thích) | POST | /v1/video/generations |
| Lấy trạng thái tác vụ video (tương thích) | GET | /v1/video/generations/{task_id} |
Âm thanh
| Mục đích | Phương thức | Đường dẫn |
|---|---|---|
| Chuyển âm thanh thành văn bản | POST | /v1/audio/transcriptions |
| Dịch âm thanh | POST | /v1/audio/translations |
| Chuyển văn bản thành giọng nói | POST | /v1/audio/speech |
Vector và truy hồi
| Mục đích | Phương thức | Đường dẫn |
|---|---|---|
| Embedding văn bản | POST | /v1/embeddings |
| Xếp hạng lại tài liệu | POST | /v1/rerank |
An toàn và realtime
| Mục đích | Phương thức | Đường dẫn |
|---|---|---|
| Kiểm duyệt nội dung | POST | /v1/moderations |
| Realtime (WebSocket) | GET | /v1/realtime |
Yêu cầu tối thiểu
Ứng dụng thường dùng Base URL https://api.popgo.site/v1 và xác thực bằng Authorization: Bearer YOUR_API_KEY. Thay YOUR_MODEL bằng ID trên trang mô hình và xác nhận mô hình hỗ trợ endpoint cần dùng.
curl https://api.popgo.site/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_MODEL",
"messages": [
{"role": "user", "content": "Hãy xác nhận kết nối"}
]
}'
Kiểm tra
Kiểm tra mô hình và giao thức bằng yêu cầu tối thiểu trước khi bật streaming, tools hoặc tùy chọn media. Với 404, kiểm tra /v1 có bị thêm hai lần; với 400, kiểm tra khả năng của endpoint.