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

แชท

สร้างแชท

ร้องขอการตอบสนองของโมเดลสำหรับบทสนทนาแชทที่กำหนด รองรับทั้งโหมด streaming และ non-streaming ด้วยรูปแบบคำขอ/การตอบกลับที่เข้ากันได้กับ OpenAI แบบเดียวกันในทุกโมเดลและผู้ให้บริการ

POST/api/v1/chat/completions

การอนุญาต

Authorizationจำเป็น

string · header

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

Body

modelจำเป็น

string

โมเดลที่จะใช้ ในรูปแบบมีคำนำหน้าผู้ให้บริการ เช่น "openai/gpt-4.1" id แบบสั้นของตระกูลโมเดลทั่วไป (เช่น "gpt-4o") จะถูกแปลงเป็น canonical id แบบเต็มโดยอัตโนมัติ ("openai/gpt-4o"); ค่าที่เป็น canonical อยู่แล้วจะผ่านไปตามเดิม id แบบสั้นที่ไม่รู้จักจะไม่ถูกเขียนทับโดยบังคับ — ขั้นตอนแก้ไขโมเดลจะคืนข้อผิดพลาด model-not-found ที่ชัดเจนแทน

minLength: 1

Example: "openai/gpt-4.1"

messagesจำเป็น

Message[]

อาร์เรย์ของข้อความสนทนา อย่างน้อยหนึ่งรายการ แต่ละข้อความมี role (system/user/assistant/tool) และ content

minLength: 1

models

string[]

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

stream

boolean

true จะสตรีมการตอบกลับแบบ SSE; ละไว้หรือ false จะคืนค่าการตอบกลับ JSON เดียว

temperature

number

อุณหภูมิการสุ่มตัวอย่าง — ยิ่งสูงยิ่งสุ่ม ยิ่งต่ำยิ่งแน่นอน

0–2

max_tokens

integer

จำนวนโทเค็นสูงสุดที่การตอบกลับสามารถสร้างได้

max_completion_tokens

integer

ชื่อแทนของ max_tokens ที่มีความหมายเดียวกัน

top_p

number

เกณฑ์ nucleus sampling

0–1

top_k

integer

จำกัดการสุ่มตัวอย่างให้เหลือ K โทเค็นที่มีความน่าจะเป็นสูงสุด

frequency_penalty

number

ลงโทษโทเค็นตามความถี่ที่ปรากฏมาแล้ว

-2.0–2.0

presence_penalty

number

ลงโทษโทเค็นตามว่าเคยปรากฏหรือไม่ ไม่นับจำนวนครั้ง

-2.0–2.0

repetition_penalty

number

ค่าสัมประสิทธิ์บทลงโทษการซ้ำ — กลไกแยกจาก frequency/presence penalty

min_p

number

เกณฑ์ความน่าจะเป็นขั้นต่ำเทียบกับโทเค็นที่มีโอกาสสูงสุด

0–1

top_a

number

กลไกการสุ่มตัวอย่างแบบตัดขอบเขตแบบไดนามิกอีกแบบ ปรับเกณฑ์ตามกำลังสองของความน่าจะเป็นสูงสุด

seed

integer

seed สุ่มแบบกำหนดได้ ไม่ใช่ทุกผู้ให้บริการที่รับประกันการทำซ้ำได้

n

integer

จำนวนการตอบกลับที่จะสร้าง

stop

string | string[]

ลำดับที่ทำให้การสร้างหยุด สูงสุด 4 รายการ

tools

Tool[]

รายการนิยามเครื่องมือ/ฟังก์ชันที่โมเดลสามารถเรียกใช้ได้

tool_choice

string | object

ควบคุมว่าโมเดลจะถูกบังคับให้เรียกเครื่องมือหรือไม่/อย่างไร

parallel_tool_calls

boolean

อนุญาตให้เรียกเครื่องมือแบบขนานเมื่อมี tools หรือไม่ ค่าเริ่มต้น true ใช้ได้เฉพาะโมเดลตระกูล OpenAI เท่านั้น — จะถูกตัดออกอย่างเงียบ ๆ เมื่อโมเดลเป้าหมายไม่ใช่ของ OpenAI ไม่ใช่ข้อผิดพลาด

response_format

object

จำกัดรูปแบบเอาต์พุต เช่น {type:"json_object"} หรือ {type:"json_schema"} พร้อม JSON Schema

logit_bias

object

แมป ID โทเค็นไปยังค่าอคติ [-100, 100] ที่เพิ่มก่อนการสุ่มตัวอย่าง ใช้ได้เฉพาะโมเดลตระกูล OpenAI เท่านั้น — จะถูกตัดออกอย่างเงียบ ๆ เมื่อโมเดลเป้าหมายไม่ใช่ของ OpenAI ไม่ใช่ข้อผิดพลาด

logprobs

boolean

คืนค่า log probabilities ของแต่ละโทเค็นเอาต์พุต ใช้ได้เฉพาะโมเดลตระกูล OpenAI เท่านั้น — จะถูกตัดออกอย่างเงียบ ๆ เมื่อโมเดลเป้าหมายไม่ใช่ของ OpenAI ไม่ใช่ข้อผิดพลาด

top_logprobs

integer

จำนวนโทเค็นที่น่าจะเป็นไปได้มากที่สุดต่อตำแหน่ง (ต้องใช้ logprobs: true) ใช้ได้เฉพาะโมเดลตระกูล OpenAI เท่านั้น — จะถูกตัดออกอย่างเงียบ ๆ เมื่อโมเดลเป้าหมายไม่ใช่ของ OpenAI ไม่ใช่ข้อผิดพลาด

0–20

user

string

ตัวระบุผู้ใช้ปลายทางสำหรับการตรวจสอบและตรวจจับการละเมิด ไม่มีผลต่อการเรียกเก็บเงิน ใช้ได้เฉพาะโมเดลตระกูล OpenAI เท่านั้น — จะถูกตัดออกอย่างเงียบ ๆ เมื่อโมเดลเป้าหมายไม่ใช่ของ OpenAI ไม่ใช่ข้อผิดพลาด

reasoning

object

อ็อบเจ็กต์ควบคุมการคิดของโมเดล reasoning (เช่น {effort, max_tokens})

reasoning_effort

string

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

lowmediumhigh

image_config

object

ตัวเลือกการสร้าง/แก้ไขภาพ (ใช้เมื่อ modalities มี image)

modalities

string[]

โมดัลลิตีเอาต์พุตที่ร้องขอ หากมี image จะเดินทางผ่านเส้นทาง dispatch การสร้างภาพ

textimage

plugins

object[]

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

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."}]
  }'

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

สำเร็จ BazaarLink ทำการ normalize เพียงสองฟิลด์เท่านั้น — model และการลบฟิลด์ provider — แล้วส่งต่อส่วนที่เหลือของการตอบกลับจาก upstream ตามเดิม รวมถึงฟิลด์อย่าง native_finish_reason, system_fingerprint และ reasoning ที่จะปรากฏก็ต่อเมื่อผู้ให้บริการรายนั้นกำหนดค่าไว้เท่านั้น usage.cost เป็นข้อยกเว้น — เป็นจำนวนที่ BazaarLink คำนวณเองเสมอ ไม่ใช่ค่าที่ส่งต่อมาจาก 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
  }
}