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

Responses API

Tạo response

Yêu cầu phản hồi mô hình theo định dạng yêu cầu của OpenAI Responses API (input/instructions); được chuyển đổi nội bộ sang định dạng Chat Completions và định tuyến đến bất kỳ model được hỗ trợ nào — đây là lớp dịch, không phải một đường dẫn suy luận riêng. Đây là endpoint không trạng thái: truyền store: true hoặc previous_response_id khác null sẽ trả về 400 (xem mục 400 bên dưới để biết dạng lỗi riêng biệt) — mỗi lần gọi phải mang toàn bộ cuộc hội thoại trong input. Khi streaming, reasoning được thể hiện qua các sự kiện response.reasoning_text.delta và một output item type:"reasoning".

POST/v1/responses

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-5.4".

minLength: 1

Example: "openai/gpt-5.4"

inputbắt buộc

string | InputItem[]

Đầu vào hội thoại — một chuỗi đơn, hoặc mảng item có cấu trúc (message/function_call/function_call_output). Tin nhắn có thể dùng văn bản thuần hoặc mảng khối nội dung gồm input_image.

instructions

string

Chỉ dẫn cấp hệ thống, được chèn làm tin nhắn system đầu tiên ở đầu mảng messages đã chuyển đổi.

stream

boolean

true để phản hồi dạng luồng sự kiện SSE của Responses API (response.created, response.output_item.added, response.output_text.delta, response.reasoning_text.delta, response.completed, và các sự kiện khác); bỏ qua hoặc false trả về một phản hồi JSON đơn.

max_output_tokens

integer

Số token tối đa mà phản hồi có thể tạo ra (chuyển đổi thành max_tokens của Chat Completions upstream).

tools

Tool[]

Danh sách định nghĩa tool/hàm mà model có thể gọi. Chấp nhận dạng phẳng theo spec Responses {type:"function", name, description, parameters} (khuyến nghị), và cả dạng lồng của Chat Completions {type:"function", function:{...}} (chấp nhận để tương thích ngược, chuyển tiếp nguyên trạng). Trường tools của đối tượng response phản chiếu đúng giá trị đã gửi ở đây.

tool_choice

string | object

Kiểm soát việc model có/thế nào bị buộc gọi tool, ví dụ {type:"function", name:"..."} (dạng phẳng, khuyến nghị, tự động chuyển đổi cho upstream) hoặc "auto". Trường tool_choice của response phản chiếu giá trị đã gửi ở đây, mặc định "auto" khi bỏ qua.

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 khi bỏ qua; trường parallel_tool_calls của response phản chiếu giá trị đã gửi ở đây.

plugins

object[]

Mảng plugin (ví dụ {id:"web"} để bật tìm kiếm web). Chỉ một số tuyến model hỗ trợ, nơi khác không có tác dụng; :online bật tìm kiếm web trên tuyến được hỗ trợ. Tìm kiếm qua plugins, :online hoặc web_search_options có thể phát sinh phí bổ sung từ upstream, tính trên khóa được dùng: khóa nền tảng của BazaarLink hoặc khóa BYOK của bạn.

store

boolean

⚠️ Endpoint này không trạng thái — truyền true sẽ trả về 400 ngay lập tức, không bao giờ được chấp nhận hay âm thầm bỏ qua. Bỏ qua hoặc truyền false là cách dùng hợp lệ duy nhất.

previous_response_id

string

⚠️ Endpoint này không trạng thái — truyền bất kỳ giá trị khác null nào sẽ trả về 400 ngay lập tức, không bao giờ được chấp nhận hay âm thầm bỏ qua. Để tiếp tục hội thoại, hãy gửi toàn bộ lịch sử trong mảng input.

models

string[]

Danh sách model dự phòng — được thử theo thứ tự sau khi nhóm ứng viên của model chính đã hết. BazaarLink tự định tuyến từng model dự phòng và tính giá khách hàng của BazaarLink cho model đó; danh sách không được chuyển tiếp lên upstream.

reasoning

object

Đối tượng điều khiển suy luận của model reasoning (ví dụ {effort, max_tokens}), chuyển tiếp nguyên trạng lên upstream — không tiêm giá trị mặc định.

reasoning_effort

string

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

lowmediumhigh

thinking

object

Ngân sách token cộng thêm của extended thinking Claude (ví dụ {type:"enabled", budget_tokens:2048}), cộng thêm vào max_output_tokens — chuyển tiếp nguyên trạng, không tiêm giá trị mặc định.

enable_thinking

boolean

Công tắc bật/tắt thinking cho các model họ Qwen3/GLM, chuyển tiếp nguyên trạng lựa chọn của người dùng.

POST /v1/responses

1
2
3
4
5
6
7
curl https://api.bazaarlink.ai/v1/responses \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5.4",
    "input": "What is the capital of France?"
  }'

Ví dụ phản hồi

BazaarLink trả về phản hồi chuẩn hóa và loại bỏ các trường riêng của upstream. usage.cost là số USD tính cho khách hàng cho yêu cầu này. Dùng BazaarLink request ID opaque từ id phản hồi hoặc header x-request-id với GET /v1/generation; phản hồi không stream cũng có ID đó trong x-generation-id. Số liệu có thể xuất hiện sau vài giây; thử lại 404 trong thời gian ngắn. Yêu cầu Chat, Messages và Responses không stream kéo dài (khoảng 12 giây trở lên) có thể có khoảng trắng keep-alive trước JSON body. Trình phân tích JSON tiêu chuẩn xử lý được khoảng trắng đầu.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
{
  "id": "85e6f35c71a31f19-SJC",
  "object": "response",
  "created_at": 1753500000,
  "completed_at": 1753500002,
  "status": "completed",
  "model": "openai/gpt-5.4",
  "output": [
    {
      "type": "reasoning",
      "id": "bazaarlink-reasoning-item-id",
      "status": "completed",
      "summary": [],
      "content": [
        {
          "type": "reasoning_text",
          "text": "The user is asking a simple geography fact..."
        }
      ]
    },
    {
      "type": "message",
      "id": "bazaarlink-message-item-id",
      "role": "assistant",
      "status": "completed",
      "content": [
        {
          "type": "output_text",
          "text": "The capital of France is Paris.",
          "annotations": []
        }
      ]
    }
  ],
  "usage": {
    "input_tokens": 14,
    "output_tokens": 32,
    "total_tokens": 46,
    "cost": 0.00021,
    "bz_cost": 0.00021,
    "output_tokens_details": {
      "reasoning_tokens": 18
    }
  },
  "error": null,
  "incomplete_details": null,
  "tool_choice": "auto",
  "tools": [],
  "truncation": "auto",
  "parallel_tool_calls": true,
  "metadata": {},
  "store": false
}