Tài liệu Tham chiếu API Tham chiếu SDK Sử dụng Agent Kỹ năng AI

Trò chuyện

Tạo cuộc trò chuyện

Yêu cầu phản hồi từ mô hình cho cuộc trò chuyện đã cho. Hỗ trợ cả chế độ streaming và không streaming, với một định dạng yêu cầu/phản hồi tương thích OpenAI dùng chung cho mọi mô hình và nhà cung cấp.

POST/api/v1/chat/completions

Xác thực

Authorizationbắt buộc

string · header

API key dưới dạng bearer token trong header Authorization.

Body

modelbắt buộc

string

Model cần dùng, có tiền tố nhà cung cấp, ví dụ "openai/gpt-4.1". Id ngắn của các họ model phổ biến (ví dụ "gpt-4o") được tự động phân giải thành id canonical đầy đủ ("openai/gpt-4o"); giá trị đã ở dạng canonical được chuyển tiếp nguyên trạng. Id ngắn không nhận diện được sẽ không bị ghi đè — bước phân giải model sẽ trả về lỗi model-not-found rõ ràng.

minLength: 1

Example: "openai/gpt-4.1"

messagesbắt buộc

Message[]

Mảng các tin nhắn hội thoại, ít nhất một. Mỗi tin nhắn có role (system/user/assistant/tool) và content.

minLength: 1

models

string[]

Danh sách model dự phòng — thử theo thứ tự, chỉ dùng khi nhóm ứng viên của model chính đã cạn.

stream

boolean

true để phản hồi dạng luồng SSE; bỏ qua hoặc false trả về một phản hồi JSON đơn.

temperature

number

Nhiệt độ lấy mẫu — càng cao càng ngẫu nhiên, càng thấp càng xác định.

0–2

max_tokens

integer

Số token tối đa mà phản hồi có thể tạo ra.

max_completion_tokens

integer

Bí danh của max_tokens với ngữ nghĩa giống hệt.

top_p

number

Ngưỡng lấy mẫu nhân (nucleus sampling).

0–1

top_k

integer

Giới hạn lấy mẫu trong K token có xác suất cao nhất.

frequency_penalty

number

Phạt token dựa trên tần suất đã xuất hiện.

-2.0–2.0

presence_penalty

number

Phạt token dựa trên việc đã từng xuất hiện hay chưa, bất kể số lần.

-2.0–2.0

repetition_penalty

number

Hệ số phạt lặp lại — cơ chế riêng biệt với frequency/presence penalty.

min_p

number

Ngưỡng xác suất tối thiểu tương đối so với token có khả năng cao nhất.

0–1

top_a

number

Một cơ chế lấy mẫu cắt ngưỡng động khác, co giãn ngưỡng theo bình phương xác suất cao nhất.

seed

integer

Seed lấy mẫu xác định; không phải nhà cung cấp nào cũng đảm bảo khả năng tái tạo.

n

integer

Số lượng phản hồi cần tạo.

stop

string | string[]

Chuỗi khiến việc tạo dừng lại, tối đa 4.

tools

Tool[]

Danh sách định nghĩa tool/hàm mà model có thể gọi.

tool_choice

string | object

Kiểm soát việc model có/thế nào bị buộc gọi tool.

parallel_tool_calls

boolean

Có cho phép gọi tool song song khi cung cấp tools hay không. Mặc định true. Chỉ áp dụng cho mô hình họ OpenAI — bị loại bỏ âm thầm khi mô hình đích không phải của OpenAI, không phải lỗi.

response_format

object

Ràng buộc định dạng đầu ra, ví dụ {type:"json_object"} hoặc {type:"json_schema"} kèm JSON Schema.

logit_bias

object

Ánh xạ ID token đến giá trị thiên lệch [-100, 100] được thêm trước khi lấy mẫu. Chỉ áp dụng cho mô hình họ OpenAI — bị loại bỏ âm thầm khi mô hình đích không phải của OpenAI, không phải lỗi.

logprobs

boolean

Trả về log xác suất của mỗi token đầu ra. Chỉ áp dụng cho mô hình họ OpenAI — bị loại bỏ âm thầm khi mô hình đích không phải của OpenAI, không phải lỗi.

top_logprobs

integer

Số token có khả năng nhất trả về cho mỗi vị trí (cần logprobs: true). Chỉ áp dụng cho mô hình họ OpenAI — bị loại bỏ âm thầm khi mô hình đích không phải của OpenAI, không phải lỗi.

0–20

user

string

Định danh người dùng cuối cho giám sát và phát hiện lạm dụng. Không ảnh hưởng thanh toán. Chỉ áp dụng cho mô hình họ OpenAI — bị loại bỏ âm thầm khi mô hình đích không phải của OpenAI, không phải lỗi.

reasoning

object

Đối tượng điều khiển suy luận của model reasoning (ví dụ {effort, max_tokens}).

reasoning_effort

string

Trường viết tắt phẳng của reasoning.effort.

lowmediumhigh

image_config

object

Tùy chọn tạo/chỉnh sửa ảnh (dùng khi modalities gồm image).

modalities

string[]

Các modality đầu ra được yêu cầu. Có image sẽ định tuyến qua luồng tạo ảnh.

textimage

plugins

object[]

Mảng plugin (ví dụ {id:"web"} để bật tìm kiếm web). Chỉ được hỗ trợ trên một số tuyến model, không có hiệu lực ở nơi khác; biến thể model :online tự động chèn {id:"web"}, cũng chỉ trên các tuyến hỗ trợ.

POST /api/v1/chat/completions

1
2
3
4
5
6
7
curl https://bazaarlink.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4.1",
    "messages": [{"role": "user", "content": "Explain quantum computing in one paragraph."}]
  }'

Ví dụ phản hồi

Thành công. BazaarLink chỉ chuẩn hóa đúng hai trường — model, và việc loại bỏ trường provider — rồi chuyển tiếp phần còn lại của phản hồi upstream nguyên trạng, bao gồm các trường như native_finish_reason, system_fingerprint, và reasoning chỉ tồn tại khi nhà cung cấp đó điền vào. usage.cost là ngoại lệ — luôn là số tiền BazaarLink tự quyết toán, không phải giá trị chuyển tiếp từ upstream.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1740000000,
  "model": "openai/gpt-4o",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Quantum computing leverages quantum mechanics..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 28,
    "completion_tokens": 74,
    "total_tokens": 102,
    "cost": 0.000648
  }
}