Tài liệu AI API tương thích OpenAI

Tích hợp nhiều mô hình AI qua một gateway với SDK quen thuộc, một Base URL và API Key.

Mở hướng dẫn tích hợp

Tham chiếu API

Sau khi yêu cầu đầu tiên thành công, dùng phần này để xem tham số yêu cầu và định dạng phản hồi theo từng nhà cung cấp mô hình.

30 Endpoint API mô hình
POSTOpenAIOpenAI/chat/completions

Tạo Chat Completion

Tạo phản hồi mô hình từ lịch sử hội thoại, có hỗ trợ truyền theo luồng, công cụ và thống kê sử dụng.

Xác thực

Dùng khóa API của bạn với Authorization: Bearer sk-xxxx.

Authorization: Bearer sk-xxxx
Loại nội dung
application/json
Ví dụ mô hình
gpt-4o, gpt-4.1, gpt-5, o3, o4-mini

Ví dụ yêu cầu

{
  "model": "gpt-4o",
  "messages": [
    {
      "role": "user",
      "content": "Hello"
    }
  ],
  "stream": false
}

Ví dụ phản hồi

{
  "id": "chatcmpl_xxx",
  "object": "chat.completion",
  "created": 0,
  "model": "gpt-4o",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello!"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 8,
    "completion_tokens": 3,
    "total_tokens": 11
  }
}

Ví dụ curl

curl -X POST 'https://costrouter.ai/v1/chat/completions' \
  -H 'Authorization: Bearer sk-xxxx'
  -H 'Content-Type: application/json'
  -d '{
  "model": "gpt-4o",
  "messages": [
    {
      "role": "user",
      "content": "Hello"
    }
  ],
  "stream": false
}'
Tham số
TênLoạiBắt buộcMô tả
modelstringID mô hình. CostRouter dùng ID này để tìm các tuyến tương thích và khả dụng cho yêu cầu.
messagesarray<object>Mảng tin nhắn hội thoại, thường gồm các vai trò system, user, assistant hoặc tool.
temperaturenumberKhôngNhiệt độ lấy mẫu. Giá trị cao hơn tạo kết quả đa dạng hơn.
top_pnumberKhôngTham số nucleus sampling, thường được điều chỉnh thay cho temperature.
streambooleanKhôngCó trả phản hồi theo luồng hay không.
max_tokensintegerKhôngSố token đầu ra tối đa.
toolsarray<object>KhôngĐịnh nghĩa công cụ hoặc hàm. Khả năng hỗ trợ tùy thuộc mô hình của nhà cung cấp.
response_formatobjectKhôngĐịnh dạng phản hồi có cấu trúc. Khả năng hỗ trợ tùy thuộc mô hình của nhà cung cấp.
Ví dụ phản hồi
TênLoạiBắt buộcMô tả
idstringKhôngID phản hồi, tác vụ hoặc tài nguyên.
objectstringKhôngLoại đối tượng phản hồi.
createdintegerKhôngThời điểm tạo.
modelstringKhông-
choicesarray<object>KhôngCác phương án đầu ra của mô hình.
usageobjectKhôngThống kê lượng token sử dụng.

Lỗi thường gặp và cách sửa

Lỗi chạy lần đầu thường do xác thực, tên mô hình, hạn mức hoặc định dạng yêu cầu.

401

Xác thực thất bại

Kiểm tra Authorization có dùng Bearer cùng CostRouter API Key hay không.

403

Vấn đề về quyền truy cập hoặc số dư

Kiểm tra trạng thái khóa, số dư, quyền truy cập mô hình và cài đặt thanh toán.

429

Bị giới hạn tốc độ

Giảm số yêu cầu đồng thời, thử lại với backoff hoặc kiểm tra giới hạn tài khoản.

5xx

Lỗi nhà cung cấp mô hình hoặc định tuyến

Thử lại sau và xem Nhật ký sử dụng để kiểm tra trạng thái yêu cầu và tuyến mô hình.

Copyright 2026 CostRouter. Bảo lưu mọi quyền.

CostRouter bị cấm sử dụng bởi người dùng ở Trung Quốc đại lục. Nếu phát hiện việc sử dụng từ Trung Quốc đại lục, CostRouter có thể đình chỉ hoặc chấm dứt tài khoản, và các khoản phí đã thanh toán hoặc số dư còn lại sẽ không được hoàn trả.

Liên hệ

Chọn kênh phù hợp nhất với yêu cầu của bạn.

Liên hệ
Tài liệu API tương thích OpenAI | CostRouter