Đăng nhập
Tài liệu API

API Reference

Gọi dịch vụ mô hình bằng định dạng yêu cầu tương thích API chính thức của từng nhà cung cấp.

30
Endpoint API mô hình
8
Danh mục
API Key
Xác thực

API Reference

Dùng phần này sau khi yêu cầu đầu tiên chạy được hoặc khi cần chi tiết endpoint theo nhà cung cấp.

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

Create Chat Completion

Creates a model response from conversation history with streaming, tools, and usage accounting.

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ụ request

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

Ví dụ response

{
  "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
  }
}

curl Example

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ả
modelstringModel ID. The CostRouter selects an available channel by model name and forwards the request.
messagesarray<object>Conversation message array, usually with system, user, assistant, or tool roles.
temperaturenumberKhôngSampling temperature. Higher values make output more random.
top_pnumberKhôngNucleus sampling parameter, usually adjusted instead of temperature.
streambooleanKhôngWhether to return a streaming response.
max_tokensintegerKhôngSố token đầu ra tối đa.
toolsarray<object>KhôngTool or function definitions. Support depends on the upstream model.
response_formatobjectKhôngStructured response format. Support depends on the upstream model.
Ví dụ response
TênLoạiBắt buộcMô tả
idstringKhôngResponse, task, or resource ID.
objectstringKhôngResponse object type.
createdintegerKhôngCreation timestamp.
modelstringKhông-
choicesarray<object>KhôngCandidate model outputs.
usageobjectKhôngToken usage statistics.

Khái niệm cốt lõi

Đây là các phần người mới thường cần hiểu trước khi debug tích hợp.

API key: khóa CostRouter xác thực yêu cầu tới mọi mô hình được hỗ trợ.
Base URL: thay URL nhà cung cấp bằng CostRouter relay URL.
Model name: giữ tên mô hình trong payload; CostRouter chọn kênh khả dụng.
Usage and billing: chi phí xuất hiện trong Usage Logs và Billing sau khi yêu cầu hoàn tất.

Chọn mô hình

Dùng các mặc định này khi bạn chưa chắc nên bắt đầu với endpoint nào.

Chat thông thường: bắt đầu với gpt-4o-mini hoặc mô hình chat chi phí thấp.
Reasoning hoặc code: chọn mô hình mạnh hơn sau khi yêu cầu cơ bản đã chạy được.
Images, audio và video: dùng đúng danh mục endpoint trong API Reference.
Kiểm tra giá: mở Models trước traffic production để so sánh nhóm và giá.

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, quota 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

Thiếu quyền 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 upstream hoặc định tuyến

Thử lại sau và xem Usage Logs để kiểm tra trạng thái yêu cầu và tuyến mô hình.

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 - CostRouter