Tài liệu
Gọi tương thích OpenAI
Cập nhật vào 2026-07-21
/v1/chat/completions là điểm cuối chính phổ biến nhất giữa các nhà cung cấp. Thay Base URL của OpenAI SDK chính thức bằng https://api.rokoapi.com/v1, bạn có thể gọi các mô hình đã triển khai trên trang này.
Trang này tương ứng với việc kết nối ở “chế độ tương thích”; nếu bạn cần giao thức Responses gốc của OpenAI, xem Responses API.
Tại sao sử dụng chế độ tương thích
- Một bộ mã, nhiều mô hình : Cùng một SDK có thể gọi các kênh đã triển khai như DeepSeek, OpenAI, mô hình hình ảnh, v.v.
- Hệ sinh thái trưởng thành : LangChain, các plugin IDE và client proxy mặc định sử dụng Chat Completions
- Chi phí di chuyển thấp : Chỉ cần thay đổi
base_url/baseURLvàmodel
Chuyển sang Responses khi bạn cần cấu trúc output, sự kiện streaming ngữ nghĩa hoặc tính năng chỉ có trên điểm cuối này. Xem Responses API.
Bắt đầu nhanh
curl https://api.rokoapi.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "deepseek-v4-flash",
"messages": [
{"role": "system", "content": "Bạn là một trợ lý trả lời súc tích"},
{"role": "user", "content": "Hãy giới thiệu bản thân trong một câu"}
]
}'
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://api.rokoapi.com/v1",
)
resp = client.chat.completions.create(
model="deepseek-v4-flash",
messages=[
{"role": "system", "content": "Bạn là một trợ lý trả lời súc tích"},
{"role": "user", "content": "Hãy giới thiệu bản thân trong một câu"},
],
)
print(resp.choices[0].message.content)
import OpenAI from 'openai'
const client = new OpenAI({
apiKey: 'YOUR_API_KEY',
baseURL: 'https://api.rokoapi.com/v1',
})
const resp = await client.chat.completions.create({
model: 'deepseek-v4-flash',
messages: [
{ role: 'system', content: 'Bạn là một trợ lý trả lời súc tích' },
{ role: 'user', content: 'Hãy giới thiệu bản thân trong một câu' },
],
})
console.log(resp.choices[0]?.message?.content)
model model phải sử dụng ID mô hình thực tế trong Hướng dẫn phát triển mô hình đã triển khai, không sử dụng tên chưa được kích hoạt.
Tham khảo nhanh tham số yêu cầu
| Tham số | Kiểu | Mô tả |
|---|---|---|
model | string | Bắt buộc, ID mô hình đã triển khai |
messages | array | Bắt buộc, tin nhắn hội thoại |
stream | boolean | true trả về SSE khi là true |
temperature | number | Nhiệt độ lấy mẫu; một số mô hình suy luận có thể không hỗ trợ |
max_tokens / max_completion_tokens | int | Độ dài đầu ra tối đa |
tools / tool_choice | — | Gọi hàm; tùy thuộc vào mô hình và kênh hỗ trợ |
response_format | object | Ràng buộc định dạng đầu ra như JSON |
Tham khảo chi tiết hơn về các trường tại Chat Completions.
Cấu trúc phản hồi
Khi thành công, trả về JSON Chat Completion tiêu chuẩn, văn bản nằm trong choices[0].message.content. Khi lỗi, thường bao gồm error.message(và tùy chọn error.type / error.code).
Đầu ra streaming
Đặt "stream": true. Chi tiết về streaming xem Yêu cầu streaming.
Khả năng phi văn bản như hình ảnh
Tạo hình ảnh, v.v. hãy sử dụng điểm cuối tương ứng (như /v1/images/generationsbằng ID mô hình hình ảnh. Xem ví dụ cho từng dòng trong “Mô hình đã triển khai” ở thanh bên. model Thay bằng ID của mô hình hình ảnh. Xem ví dụ cho từng dòng sản phẩm trong mục “Mô hình đã triển khai” ở thanh bên.