เอกสาร API ข้อมูลอ้างอิง SDK ข้อมูลอ้างอิง การใช้งาน Agent AI ทักษะ

Responses API

สร้าง response

ร้องขอการตอบสนองของโมเดลด้วยรูปแบบคำขอของ OpenAI Responses API (input/instructions) โดยแปลงเป็นรูปแบบ Chat Completions ภายในแล้วจัดเส้นทางไปยังโมเดลที่รองรับใด ๆ — นี่คือชั้นแปล ไม่ใช่เส้นทางการอนุมานแยกต่างหาก นี่คือเอนด์พอยต์แบบไม่มีสถานะ: การส่ง store: true หรือ previous_response_id ที่ไม่ใช่ null จะคืนค่า 400 (ดูรูปแบบข้อผิดพลาดเฉพาะที่รายการ 400 ด้านล่าง) — แต่ละคำขอต้องมีบทสนทนาทั้งหมดใน input เมื่อสตรีม reasoning จะแสดงผ่านเหตุการณ์ response.reasoning_text.delta และ output item ชนิด type:"reasoning"

POST/api/v1/responses

การอนุญาต

Authorizationจำเป็น

string · header

API key เป็น bearer token ใน header Authorization

Body

modelจำเป็น

string

โมเดลที่จะใช้ ในรูปแบบมีคำนำหน้าผู้ให้บริการ เช่น "openai/gpt-5.2"

minLength: 1

Example: "openai/gpt-5.2"

inputจำเป็น

string | InputItem[]

อินพุตของบทสนทนา — สตริงเดี่ยว หรืออาร์เรย์รายการที่มีโครงสร้าง (message/function_call/function_call_output) ข้อความสามารถใช้ข้อความล้วนหรืออาร์เรย์บล็อกเนื้อหาที่มี input_image

instructions

string

คำสั่งระดับระบบ ถูกแทรกเป็นข้อความ system แรกที่ด้านหน้าของอาร์เรย์ messages ที่แปลงแล้ว

stream

boolean

true จะสตรีมการตอบกลับเป็นเหตุการณ์ SSE ของ Responses API (response.created, response.output_item.added, response.output_text.delta, response.reasoning_text.delta, response.completed และอื่น ๆ); ละไว้หรือ false จะคืนค่าการตอบกลับ JSON เดียว

max_output_tokens

integer

จำนวนโทเค็นสูงสุดที่การตอบกลับสามารถสร้างได้ (แปลงเป็น max_tokens ของ Chat Completions ที่ upstream)

tools

Tool[]

รายการนิยามเครื่องมือ/ฟังก์ชันที่โมเดลสามารถเรียกใช้ได้ รับรูปแบบแบนตามสเปก Responses {type:"function", name, description, parameters} (แนะนำ) และรูปแบบซ้อนของ Chat Completions {type:"function", function:{...}} (รับไว้เพื่อความเข้ากันได้ย้อนหลัง ส่งต่อตามเดิม) ฟิลด์ tools ของอ็อบเจ็กต์การตอบกลับจะสะท้อนค่าที่ส่งมาจริงที่นี่

tool_choice

string | object

ควบคุมว่าโมเดลจะถูกบังคับให้เรียกเครื่องมือหรือไม่/อย่างไร เช่น {type:"function", name:"..."} (รูปแบบแบน แนะนำ แปลงอัตโนมัติสำหรับ upstream) หรือ "auto" ฟิลด์ tool_choice ของอ็อบเจ็กต์การตอบกลับจะสะท้อนค่าที่ส่งมาที่นี่ ค่าเริ่มต้นเมื่อละไว้คือ "auto"

parallel_tool_calls

boolean

อนุญาตให้เรียกเครื่องมือแบบขนานเมื่อมี tools หรือไม่ ค่าเริ่มต้นเมื่อละไว้คือ true ฟิลด์ parallel_tool_calls ของอ็อบเจ็กต์การตอบกลับจะสะท้อนค่าที่ส่งมาที่นี่

plugins

object[]

อาร์เรย์ปลั๊กอิน (เช่น {id:"web"} เพื่อเปิดค้นหาเว็บ) รองรับเฉพาะบางเส้นทางโมเดล ไม่มีผลกรณีอื่น ตัวแปรโมเดล :online จะแทรก {id:"web"} อัตโนมัติเฉพาะเมื่อคุณไม่ได้ส่ง plugins มา ก็จำกัดเฉพาะเส้นทางที่รองรับเช่นกัน

store

boolean

⚠️ เอนด์พอยต์นี้ไม่มีสถานะ — การส่ง true จะคืนค่า 400 ทันที ไม่เคยถูกยอมรับหรือละเว้นอย่างเงียบ ๆ การละไว้หรือส่ง false เป็นวิธีใช้ที่ถูกต้องเพียงอย่างเดียว

previous_response_id

string

⚠️ เอนด์พอยต์นี้ไม่มีสถานะ — การส่งค่าใด ๆ ที่ไม่ใช่ null จะคืนค่า 400 ทันที ไม่เคยถูกยอมรับหรือละเว้นอย่างเงียบ ๆ หากต้องการดำเนินบทสนทนาต่อ ให้ส่งประวัติทั้งหมดในอาร์เรย์ input แทน

models

string[]

รายการโมเดลสำรอง — ลองตามลำดับ ใช้ก็ต่อเมื่อกลุ่มตัวเลือกของโมเดลหลักหมดแล้วเท่านั้น

reasoning

object

อ็อบเจ็กต์ควบคุมการคิดของโมเดล reasoning (เช่น {effort, max_tokens}) ส่งต่อไปยัง upstream ตามเดิม — ไม่มีการเติมค่าเริ่มต้น

reasoning_effort

string

ฟิลด์แบบย่อของ reasoning.effort

lowmediumhigh

thinking

object

งบประมาณโทเค็นเพิ่มเติมของ extended thinking ของ Claude (เช่น {type:"enabled", budget_tokens:2048}) เพิ่มเติมจาก max_output_tokens — ส่งต่อตามเดิม ไม่มีการเติมค่าเริ่มต้น

enable_thinking

boolean

สวิตช์เปิด/ปิด thinking สำหรับโมเดลตระกูล Qwen3/GLM ส่งต่อตามที่ผู้ใช้เลือกไว้

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?"
  }'

ตัวอย่างการตอบกลับ

สำเร็จ ค่าเริ่มต้น (หรือ stream: false) คืนค่าอ็อบเจ็กต์ Response ด้านล่าง เมื่อ stream: true จะคืนค่าสตรีมเหตุการณ์ SSE ของ Responses API แทน model จะสะท้อนชื่อที่คุณร้องขอเสมอ output[] ประกอบด้วยสิ่งที่สร้างขึ้นจริง: รายการ type:"reasoning" มาก่อนเมื่อมีเนื้อหา reasoning ตามด้วยรายการข้อความ type:"message" (อาร์เรย์ annotations ในเนื้อหาอาจมีแหล่งอ้างอิง เช่น url_citation จากผลค้นหาเว็บ) หรือรายการ type:"function_call" usage แปลงมาจาก usage ของ Chat Completions ที่อยู่เบื้องหลัง (input_tokens/output_tokens/total_tokens/cost) พร้อม output_tokens_details.reasoning_tokens เพิ่มเติมเมื่อมีการใช้โทเค็น reasoning tool_choice/tools/parallel_tool_calls จะสะท้อนค่าที่คุณส่งมาจริงในคำขอ

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
}