Tạo một Chat Completion

Tạo phản hồi của mô hình dựa trên lịch sử hội thoại. Hỗ trợ phản hồi streaming và không streaming. Tương thích với OpenAI Chat Completions API.

POST /v1/chat/completions

URL gốc của dịch vụ: https://getrouter.ai

Giao thức: OpenAI Chat Completions

Xác thực: Authorization: Bearer YOUR_API_KEY

Nội dung yêu cầu

Nội dung yêu cầu là bắt buộc. Loại nội dung: application/json

Trường yêu cầu

Trường	Kiểu	Bắt buộc	Mô tả
`model`	`string`	Có	model ID
`messages`	`array<object>`	Có	Danh sách tin nhắn hội thoại
`temperature`	`number`	Không	Nhiệt độ lấy mẫu Giá trị mặc định: `1`; Khoảng giá trị: 0–2
`top_p`	`number`	Không	Tham số lấy mẫu hạt nhân Giá trị mặc định: `1`; Khoảng giá trị: 0–1
`n`	`integer`	Không	Số lượng kết quả cần tạo Giá trị mặc định: `1`; Khoảng giá trị: 1–∞
`stream`	`boolean`	Không	Có streaming phản hồi hay không Giá trị mặc định: `false`
`stream_options`	`object`	Không	—
`stop`	`string or array<string>`	Không	Chuỗi dừng
`max_tokens`	`integer`	Không	Số token tối đa cần tạo
`max_completion_tokens`	`integer`	Không	Số token hoàn tất tối đa
`presence_penalty`	`number`	Không	Giá trị mặc định: `0`; Khoảng giá trị: -2–2
`frequency_penalty`	`number`	Không	Giá trị mặc định: `0`; Khoảng giá trị: -2–2
`logit_bias`	`object`	Không	—
`user`	`string`	Không	—
`tools`	`array<object>`	Không	—
`tool_choice`	`string or object`	Không	—
`response_format`	`object`	Không	—
`seed`	`integer`	Không	—
`reasoning_effort`	`string`	Không	Mức độ suy luận (dùng cho các mô hình hỗ trợ suy luận) Giá trị cho phép: `low`, `medium`, `high`
`modalities`	`array<string>`	Không	—
`audio`	`object`	Không	—

Ví dụ yêu cầu

curl --request POST \
  --url https://getrouter.ai/v1/chat/completions \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "MODEL_ID",
  "messages": [
    {
      "role": "system",
      "content": "Xin chào, hãy giới thiệu về bạn."
    }
  ],
  "stream": false,
  "temperature": 1,
  "max_tokens": 1
}'

Phản hồi

Trạng thái	Mô tả
`200`	Tạo phản hồi thành công
`400`	Tham số yêu cầu không hợp lệ
`429`	Đã vượt giới hạn tốc độ yêu cầu

Các trường của phản hồi thành công

Trường	Kiểu	Bắt buộc	Mô tả
`id`	`string`	Không	—
`object`	`string`	Không	—
`created`	`integer`	Không	—
`model`	`string`	Không	—
`choices`	`array<object>`	Không	—
`usage`	`object`	Không	—
`system_fingerprint`	`string`	Không	—

Ví dụ phản hồi

{
  "id": "string",
  "object": "object",
  "created": 1,
  "model": "MODEL_ID",
  "choices": [
    {
      "index": 1,
      "message": {
        "role": "system",
        "content": "Xin chào, hãy giới thiệu về bạn.",
        "name": "string",
        "tool_calls": [
          {
            "id": null,
            "type": null,
            "function": null
          }
        ],
        "tool_call_id": "string",
        "reasoning_content": "string"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 1,
    "completion_tokens": 1,
    "total_tokens": 1,
    "prompt_tokens_details": {
      "cached_tokens": 1,
      "text_tokens": 1,
      "audio_tokens": 1,
      "image_tokens": 1
    },
    "completion_tokens_details": {
      "text_tokens": 1,
      "audio_tokens": 1,
      "reasoning_tokens": 1
    }
  },
  "system_fingerprint": "string"
}

Hướng dẫn liên quan

Để xem quy trình và ví dụ đầy đủ, hãy đọc hướng dẫn API Chat Completions.

Trang này được tạo từ đặc tả OpenAPI công khai của Relay. Xem đặc tả đầy đủ trong API Explorer.

#Tạo một Chat Completion

#Nội dung yêu cầu

#Trường yêu cầu

#Ví dụ yêu cầu

#Phản hồi

#Các trường của phản hồi thành công

#Ví dụ phản hồi

#Hướng dẫn liên quan