สนามทดลอง API

อินเทอร์แอกทีฟ

ลองทุกโมเดลและทุก endpoint ในเบราว์เซอร์ด้วยคีย์ของคุณเอง — เอาต์พุตแบบสตรีม ตัวตรวจสอบคำขอ และโค้ดที่สร้างให้ซึ่งวางลงในแอปของคุณได้ทันที

เปิด Playground

playground คือคอนโซลแชตสำหรับ API ที่ /docs/playground คุณคุยกับโมเดล และ playground จะส่งคำขอเดียวกับที่โค้ดของคุณจะส่ง: ไปยังหนึ่งในสาม endpoint พร้อมโมเดล system prompt พารามิเตอร์ และ tool ที่คุณตั้งไว้ ทุกคำขอย้อนอ่านได้ทั้งเป็นโค้ดและเป็น stream event ดิบ

เริ่มต้น

ใส่คีย์ — เมื่อลงชื่อเข้าใช้ playground จะใช้ API key ของบัญชีคุณและแสดงยอดคงเหลือ หากยังไม่ได้ลงชื่อเข้าใช้ ให้เลือก เพิ่มคีย์ แล้ววางคีย์: คีย์จะเก็บไว้ในแท็บนี้เท่านั้นและไม่ถูกบันทึก
เลือก endpoint และโมเดล — แถบด้านบนมีสวิตช์ endpoint และตัวเลือกโมเดล บทสนทนาใหม่เริ่มบน Chat Completions ด้วย shannon-3
ส่งข้อความ — พิมพ์ด้านล่างแล้วกด Enter ทุกคำตอบจะเข้าสู่บทสนทนา ข้อความถัดไปจึงต่อเนื่องจากนั้น หน้าจอว่างมี prompt เริ่มต้นสามตัวและตัวอย่างการเรียก tool ที่พร้อมใช้

คุณดูและหมุนเวียนคีย์ (rotate) ได้ที่หน้าคีย์และการใช้งาน คีย์และการใช้งาน

Endpoint และโมเดล

สวิตช์ endpoint กำหนดว่า playground จะสร้างคำขอในรูปแบบใด คุณเปลี่ยนได้กลางบทสนทนา ข้อความยังคงอยู่

เอนด์พอยต์	คำขอที่ส่ง	อ้างอิง
Chat Completions	`POST /v1/chat/completions`	Chat Completions
Responses	`POST /v1/responses`	Responses API
Messages	`POST /v1/messages`	รูปแบบ Anthropic

ตัวเลือกโมเดลแสดงรายการที่ GET /v1/models คืนมา ค้นหาได้ เก็บโมเดลที่ใช้ล่าสุดไว้ด้านบน และแสดงของแต่ละโมเดลคือราคาต่อ 1M tokens ขนาด context window และเครื่องหมายของ tool การรับรูปภาพ การให้เหตุผล และเอาต์พุตแบบมีโครงสร้าง

บทสนทนา

คำตอบจะสตรีมเข้าสู่บทสนทนาขณะที่เขียน การให้เหตุผลของโมเดลแสดงในบล็อกของตัวเองที่พับได้
ใต้แต่ละคำตอบ: เวลาถึง token แรก tokens ต่อวินาที เวลาที่ใช้ tokens อินพุตและเอาต์พุตพร้อมส่วนที่แคชและส่วนการให้เหตุผล ค่าใช้จ่ายโดยประมาณของรอบนั้น เหตุผลที่จบ (finish reason) และ response id
แก้ไขข้อความของคุณแล้วส่งใหม่จากจุดนั้นได้ สร้างคำตอบใหม่ได้ ลบข้อความได้ และยกเลิกการลบได้ภายในไม่กี่วินาที
หยุด หรือปุ่ม Esc ยุติคำตอบที่กำลังเขียน
แนบรูปภาพด้วยปุ่มรูปภาพ การวาง หรือการลากไฟล์มาวาง สำหรับโมเดลที่รับรูปภาพ รูปภาพจะถูกย่อให้ด้านยาวไม่เกิน 1,568 พิกเซลก่อนส่ง ไฟล์ที่ใหญ่กว่า 30 MB จะถูกข้าม
ช่องเขียนข้อความและ system prompt แสดงจำนวน tokens สำหรับโมเดล open-weight ที่โฮสต์ เป็นจำนวนที่แน่นอนจาก POST /v1/tokenize สำหรับโมเดลอื่นเป็นค่าประมาณ ทำเครื่องหมายด้วย ≈
คำขอที่ล้มเหลวจะแสดงสิ่งที่ควรทำต่อ: ตั้งคีย์เมื่อคีย์ถูกปฏิเสธ เติมเครดิตเมื่อยอดคงเหลือหมด จำนวนวินาทีที่ต้องรอหลังมีคำขอมากเกินไป หรือลองใหม่หลังข้อผิดพลาดของเซิร์ฟเวอร์

การตั้งค่าคำขอ

ปุ่ม การตั้งค่า เปิดแผงที่มีหกแท็บ การตั้งค่าเป็นของบทสนทนา: แต่ละบทสนทนาเก็บค่าของตัวเอง

แท็บ	สิ่งที่เก็บไว้
ระบบ	system prompt ของบทสนทนา ส่งไปกับทุกคำขอ มีเทมเพลตห้าแบบให้เติม และแสดงจำนวน tokens ของ prompt
พารามิเตอร์	Max output tokens, temperature, `top_p`, reasoning effort, ลำดับหยุด (stop sequences), `seed` และสวิตช์สำหรับสตรีมและการค้นหาเว็บ ตัวควบคุมที่ endpoint ที่เลือกไม่มีฟิลด์รองรับจะถูกปิดและทำเครื่องหมายไว้
เครื่องมือ	นิยาม tool ที่ส่งไปกับคำขอ: พรีเซ็ตสี่แบบ (`get_weather`, `read_file`, `run_shell`, `web_search`) หรือนิยามของคุณเองเป็น JSON และ `tool_choice` (`auto`, `none`, `required` หรือหนึ่ง tool ตามชื่อ) เมื่อโมเดลเรียก tool บทสนทนาจะแสดงการเรียกพร้อมช่องสำหรับผลลัพธ์ เมื่อเปิด เสนอผลลัพธ์ตัวอย่าง คลิกครั้งเดียวจะเติมผลลัพธ์ตัวอย่างให้ คุณพิมพ์ผลลัพธ์เองได้เช่นกัน แล้วส่งเพื่อดำเนินรอบต่อ
Structured	`response_format`: `text`, `json_object` หรือ `json_schema` พร้อมชื่อ schema และ JSON schema เมื่อตั้ง schema คำตอบสุดท้ายจะถูกตรวจกับ schema นั้นและทำเครื่องหมายในบทสนทนาว่าตรงหรือไม่ แท็บนี้ถูกปิดบน endpoint Messages และตัวเลือกที่โมเดลที่เลือกไม่รองรับจะไม่แสดง
โค้ด	คำขอของบทสนทนาปัจจุบันเป็นโค้ด cURL, Python, Node หรือ Go สร้างจากบทสนทนาและการตั้งค่า คีย์จะแสดงเป็น `YOUR_API_KEY` คัดลอกโค้ดได้หรือเปิดในมุมมองขนาดใหญ่
Events	รอบล่าสุดตามที่ส่งผ่านเครือข่ายจริง: ทุก stream event พร้อมเวลาออฟเซ็ตและตัวกรอง คำตอบที่ประกอบแล้ว เฮดเดอร์ของคำตอบ (`x-request-id`, `content-type`, `retry-after`, `date`) และ body ของคำขอ ข้อมูลเหล่านี้เก็บไว้จนกว่าจะโหลดหน้าซ้ำ

การตรวจอินพุต

ค่าที่คุณพิมพ์จะถูกตรวจก่อนส่งคำขอ ค่านอกช่วงจะถูกทำเครื่องหมายที่ช่องนั้น และการส่งจะถูกระงับจนกว่าจะแก้ไข

การตั้งค่า	การตรวจ
Max output tokens	จำนวนเต็มตั้งแต่ 1 ถึง `max_output_tokens` ของโมเดล
Temperature	ตัวเลขตั้งแต่ 0 ถึง 2 หากเว้นว่าง ฟิลด์นี้จะไม่อยู่ในคำขอ
`top_p`	ตัวเลขตั้งแต่ 0 ถึง 1 หากเว้นว่าง ฟิลด์นี้จะไม่อยู่ในคำขอ
`seed`	จำนวนเต็ม
ลำดับหยุด (stop sequences)	ไม่เกิน 4 รายการ คั่นด้วยเครื่องหมายจุลภาค
`response_format`	ต้องเป็นค่าที่โมเดลที่เลือกรองรับ บทสนทนาที่ย้ายไปยังโมเดลที่ไม่มี `json_schema` หรือไม่มี `response_format` จะถูกระงับพร้อมแจ้งเหตุผล
รูปภาพ	จะถูกนำออกจากข้อความเมื่อคุณสลับไปยังโมเดลที่รับเฉพาะข้อความ พร้อมหมายเหตุ

เปรียบเทียบสองโมเดล

เปรียบเทียบสองโมเดล ในเมนู เพิ่มเติม จะเพิ่มตัวเลือกโมเดลที่สอง จากนั้นแต่ละข้อความจะถูกส่งไปยังทั้งสองโมเดลพร้อมกันด้วยการตั้งค่าเดียวกัน และคำตอบทั้งสองแสดงเคียงข้างกัน ทำเครื่องหมาย A และ B คุณสร้างคำตอบใหม่ทีละฝั่งได้ เมื่อฝั่งใดเรียก tool ผลลัพธ์ที่คุณส่งจะต่อเนื่องเฉพาะฝั่งนั้น

คัดลอกลิงก์แชร์ บรรจุบทสนทนาลงในลิงก์เอง ในส่วนหลัง # ไม่มีการอัปโหลดอะไร รูปภาพ คีย์ของคุณ และรายละเอียดของการรันล่าสุดจะไม่รวมอยู่ด้วย ผู้ที่เปิดลิงก์จะได้บทสนทนาเป็นบทสนทนาใหม่ใน playground ของตนเอง
บทสนทนาที่ยาวเกินกว่าจะใส่ในลิงก์จะถูกปฏิเสธพร้อมหมายเหตุ ให้ดาวน์โหลดเป็น JSON แทน
ดาวน์โหลด JSON ของบทสนทนา บันทึกบทสนทนาพร้อมการตั้งค่าเป็นไฟล์ นำเข้า JSON ในแผงบทสนทนาเปิดไฟล์เช่นนั้น
คัดลอกเป็น cURL คัดลอกคำขอปัจจุบันเป็นคำสั่ง cURL หนึ่งคำสั่ง

สิ่งที่เก็บไว้ที่ใด

อะไร	เก็บไว้ที่ใด
บทสนทนา tool ที่บันทึก โมเดลล่าสุด เลย์เอาต์ของแผง	ในเบราว์เซอร์นี้ ไม่ถูกส่งไปยัง Shannon และไม่ตามคุณไปยังอุปกรณ์อื่น
API key	ในหน่วยความจำของแท็บที่เปิดอยู่ คีย์ที่วางไว้จะหายเมื่อโหลดหน้าซ้ำหรือปิดแท็บ เมื่อลงชื่อเข้าใช้ จะอ่านคีย์จากบัญชีของคุณทุกครั้ง
stream event เฮดเดอร์ และคำขอของรอบล่าสุด	ในหน้าที่เปิดอยู่ จนกว่าจะโหลดซ้ำ
คำขอ	ส่งจากเบราว์เซอร์ของคุณไปยัง API พร้อมคีย์ของคุณ นับรวมกับยอดคงเหลือของคุณเหมือนคำขอ API อื่น

แป้นพิมพ์

ปุ่ม	ทำอะไร
`Enter`	ส่งข้อความ
`Shift` + `Enter`	ขึ้นบรรทัดใหม่
`Ctrl` + `K`	เปิด command palette: สลับ endpoint หรือโมเดล ตั้งเทมเพลต system เริ่มบทสนทนาใหม่ สลับสตรีม tool หรือการเปรียบเทียบ บน Mac: ⌘ K
`Esc`	หยุดคำตอบที่กำลังเขียน หรือปิดแผงที่เปิดอยู่บนหน้าจอแคบ