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 / baseURLmodel

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ểuMô tả
modelstringBắt buộc, ID mô hình đã triển khai
messagesarrayBắt buộc, tin nhắn hội thoại
streambooleantrue trả về SSE khi là true
temperaturenumberNhiệt độ lấy mẫu; một số mô hình suy luận có thể không hỗ trợ
max_tokens / max_completion_tokensintĐộ dài đầu ra tối đa
tools / tool_choiceGọi hàm; tùy thuộc vào mô hình và kênh hỗ trợ
response_formatobjectRà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.

Liên kết liên quan