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/api/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.2".

minLength: 1

Example: "openai/gpt-5.2"

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ỉ đượ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"} chỉ khi bạn không gửi plugins nào, cũng chỉ trên các tuyến hỗ trợ.

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 — thử theo thứ tự, chỉ dùng khi nhóm ứng viên của model chính đã cạn.

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 /api/v1/responses

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

Ví dụ phản hồi

Thành công. Mặc định (hoặc stream: false) trả về đối tượng Response bên dưới; với stream: true, trả về luồng sự kiện SSE của Responses API. model luôn phản ánh tên bạn đã yêu cầu. output[] gồm những gì thực sự được tạo ra: một item type:"reasoning" đứng đầu khi có nội dung reasoning, tiếp theo là item văn bản type:"message" (mảng annotations trong content có thể mang nguồn trích dẫn, ví dụ url_citation từ kết quả tìm kiếm web), hoặc item type:"function_call". usage được chuyển đổi từ usage của Chat Completions bên dưới (input_tokens/output_tokens/total_tokens/cost), kèm output_tokens_details.reasoning_tokens khi có dùng token reasoning. tool_choice/tools/parallel_tool_calls phản ánh đúng giá trị bạn đã gửi trong yêu cầ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
{
  "id": "resp_6f2a1c9d8e7b4a3f9c1d2e3f",
  "object": "response",
  "created_at": 1753500000,
  "completed_at": 1753500002,
  "status": "completed",
  "model": "openai/gpt-5.2",
  "output": [
    {
      "type": "reasoning",
      "id": "rs_1a2b3c4d5e6f7a8b9c0d1e2f",
      "status": "completed",
      "summary": [],
      "content": [
        {
          "type": "reasoning_text",
          "text": "The user is asking a simple geography fact..."
        }
      ]
    },
    {
      "type": "message",
      "id": "msg_9f8e7d6c5b4a3f2e1d0c9b8a",
      "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,
    "output_tokens_details": {
      "reasoning_tokens": 18
    }
  },
  "error": null,
  "incomplete_details": null,
  "tool_choice": "auto",
  "tools": [],
  "truncation": "auto",
  "parallel_tool_calls": true,
  "metadata": {},
  "store": false
}