POST /v1/chat/completions

คู่มือนักพัฒนา

GLM-5 API: ตั้งแต่คำขอแรกไปจนถึงระดับ Production

โมเดล GLM-5 ทุกตัวให้บริการผ่าน chat completions API ที่เข้ากันได้กับ OpenAI คุณสามารถเรียกใช้บนแพลตฟอร์มของ Z.ai เอง หรือผ่าน OpenRouter คู่มือนี้ครอบคลุมทั้งสองแบบ พร้อมราคา, รหัสโมเดล, การควบคุม reasoning, input รูปภาพ และโค้ดที่พร้อมคัดลอกไปใช้งาน

ข้ามไปที่โค้ด ทดลองใช้งานในแชทฟรี

ภาพประกอบสไตล์พิมพ์เขียวแสดงการส่งคำขอ API ระหว่างแล็ปท็อปและเซิร์ฟเวอร์แร็ค

§ 01สองช่องทาง

ช่องทางที่คุณสามารถเรียกใช้ GLM-5

แพลตฟอร์มของ Z.ai

Z.ai ซึ่งเป็นผู้พัฒนา GLM ให้บริการ API ของตนเอง โดย endpoint ทั่วไปคือ https://api.z.ai/api/paas/v4/chat/completions และทำงานตามโปรโตคอล OpenAI chat completions ทำให้ใช้ SDK ทางการของ OpenAI ได้ทันทีเพียงเปลี่ยน base URL นอกจากนี้ เอกสารของ Z.ai ยังมี coding endpoint (https://api.z.ai/api/coding/paas/v4), Responses-style endpoint (https://api.z.ai/api/v1) และ Anthropic-compatible endpoint (https://api.z.ai/api/anthropic) สำหรับเครื่องมือที่ต้องการรูปแบบเหล่านั้น

บน Z.ai รหัสโมเดลจะสั้น ได้แก่ glm-5.3, glm-5.3-flash และ glm-5.3-flashx สามารถเปิดใช้งาน Thinking ด้วย "thinking": {"type": "enabled"} และกำหนดความลึกได้ด้วย reasoning_effort คุณต้องมีบัญชี Z.ai และ API key โดยตรวจสอบอัตราค่าบริการปัจจุบันได้จากหน้าราคาของ Z.ai

OpenRouter

OpenRouter เป็นแพลตฟอร์มรวบรวม API: ใช้เพียงคีย์เดียวและ endpoint เดียว (https://openrouter.ai/api/v1/chat/completions) คุณก็สามารถเข้าถึงโมเดล GLM-5 ทุกตัวร่วมกับโมเดลจากผู้พัฒนารายอื่นได้ โดยรหัสโมเดลจะมี prefix ระบุผู้ให้บริการ เช่น z-ai/glm-5.3, z-ai/glm-5.3-flash เป็นต้น และควบคุม reasoning ผ่าน reasoning object รายการเดียว เช่น {"effort": "low"}

ราคาในตารางด้านล่างเป็นราคาของ OpenRouter นอกจากนี้ เว็บไซต์นี้ยังใช้ OpenRouter ในการให้บริการแชทฟรี ดังนั้นพฤติกรรมที่คุณเห็นในแชทของเราจึงตรงกับสิ่งที่คุณจะได้รับจาก API

เลือก Z.ai หากคุณต้องการใช้แพลตฟอร์มโดยตรงของผู้พัฒนา, coding endpoint หรือการเข้าถึงที่เข้ากันได้กับ Anthropic
เลือก OpenRouter หากคุณต้องการรวมบิลเดียวสำหรับโมเดลหลายตระกูล และสลับเปลี่ยนใช้งานได้อย่างง่ายดาย
ไม่ว่าจะเลือกทางไหน โค้ดของคุณก็ยังคงเป็น request ในรูปแบบ OpenAI เหมือนเดิม เพียงแค่เปลี่ยน base URL และชื่อโมเดล

§ 02ราคา

ราคา GLM-5 API บน OpenRouter

USD ต่อ 1 ล้านโทเค็น พร้อมประมาณการสำหรับบทสนทนาทั่วไป 1,000 รอบ คลิกที่ชื่อโมเดลเพื่อดูคู่มือฉบับเต็ม

ราคา GLM-5 API บน OpenRouter
โมเดล	Model ID	Context	Input / 1M	Output / 1M	1,000 แชท*
GLM-5	z-ai/glm-5	205K	$1	$3.20	$3.74
GLM-5-Turbo	z-ai/glm-5-turbo	203K	$1.20	$4	$4.60
GLM-5V-Turbo	z-ai/glm-5v-turbo	203K	$1.20	$4	$4.60
GLM-5.1	z-ai/glm-5.1	205K	$1.40	$4.40	$5.18
GLM-5.2	z-ai/glm-5.2	1.05M	$0.0341	$7	$4.95
GLM-5.3	z-ai/glm-5.3	1.05M	$0.079	$1.40	$1.10
GLM-5.3 Flash	z-ai/glm-5.3-flash	1.05M	$0.0052	$0.1985	$0.15
GLM-5.3 FlashX	z-ai/glm-5.3-flashx	1.05M	$0.37	$1.25	$1.43
GLM-5.3 Prime	z-ai/glm-5.3-prime	1M	$2.80	$8.80	$10

*คำนวณจากบทสนทนา 1,000 รอบ โดยเฉลี่ยรอบละ 1,500 input tokens และ 700 output tokens อ้างอิงราคาจากรายการโมเดลของ OpenRouter ณ เวลาที่เขียน ทั้งนี้ reasoning tokens จะคิดค่าบริการในอัตราเดียวกับ output

§ 03โค้ด

โค้ด request พร้อมคัดลอก

ตั้งค่าคีย์ของคุณใน environment variable — ห้ามใส่ไว้ในโค้ดฝั่ง client-side หรือ public repository โดยเด็ดขาด

OpenRouter

curl https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "z-ai/glm-5.3",
    "messages": [
      {"role": "system", "content": "You are a concise senior engineer."},
      {"role": "user", "content": "Explain idempotency keys in two paragraphs."}
    ],
    "reasoning": {"effort": "low"},
    "max_tokens": 1024,
    "stream": false
  }'

แพลตฟอร์ม Z.ai

curl -X POST "https://api.z.ai/api/paas/v4/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ZAI_API_KEY" \
  -d '{
    "model": "glm-5.3",
    "messages": [{"role": "user", "content": "Summarise the CAP theorem."}],
    "thinking": {"type": "enabled"},
    "reasoning_effort": "low"
  }'

Z.ai ใช้รหัสโมเดลแบบสั้น (glm-5.3, glm-5.3-flash) และมีสวิตช์เปิด/ปิด thinking แยกต่างหาก โปรดตรวจสอบเอกสารของ Z.ai สำหรับพารามิเตอร์และขีดจำกัดล่าสุด

§ 04รายละเอียด

พารามิเตอร์สำคัญที่ควรรู้

การใช้เหตุผลคือส่วนหนึ่งของคำตอบ

GLM-5.3 จะใช้เหตุผลก่อนตอบเสมอ โดยคุณสามารถกำหนดระดับได้ ใน model card ระบุระดับ reasoning_effort ไว้ 3 ระดับ ได้แก่ low, high และ max พร้อมระบุว่าหากไม่ได้ส่งค่าใดๆ ค่าเริ่มต้นจะเป็น max สำหรับแชทและการเรียกใช้เครื่องมือทั่วไป แนะนำให้ตั้งค่า low อย่างชัดเจน คำตอบจะมาถึงเร็วกว่าและประหยัดค่าใช้จ่ายมากกว่า เนื่องจาก reasoning tokens จะถูกคิดค่าบริการในส่วนของ output

เมื่อสตรีมผ่าน OpenRouter กระบวนการใช้เหตุผลจะส่งมาใน delta.reasoning และข้อความสุดท้ายจะอยู่ใน delta.content คุณสามารถแสดงส่วนแรกเป็นแผง "thinking" แบบย่อ-ขยายได้ หรือซ่อนไว้ แต่ไม่ควรนำข้อความดังกล่าวกลับไปใส่ในประวัติการสนทนา

การส่งรูปภาพไปยัง GLM-5.3 Flash

GLM-5.3 Flash, GLM-5.3 FlashX และ GLM-5V-Turbo รองรับรูปภาพ โดยส่งข้อความของผู้ใช้เป็น array ของ parts ได้แก่ ส่วน text และส่วน image_url ซึ่ง url จะต้องเป็นที่อยู่ HTTPS สาธารณะ หรือ base64 data URL เช่น data:image/jpeg;base64,… ทั้งนี้ GLM-5.3 และ GLM-5.3 Prime รองรับเฉพาะข้อความเท่านั้น ดังนั้นควรกำหนดเส้นทางคำขอที่มีรูปภาพไปยัง Flash

ปรับขนาดรูปภาพขนาดใหญ่ก่อนส่ง โดยให้ด้านยาวอยู่ที่ประมาณ 1,024 pixels จะช่วยให้ขนาดคำขอมีขนาดเล็กและเพียงพอสำหรับคำถามส่วนใหญ่เกี่ยวกับเอกสาร แผนภูมิ และภาพหน้าจอ

ขีดจำกัด Context และ Output

GLM-5.2, GLM-5.3 และ GLM-5.3 Flash ระบุ context ไว้ที่ 1,048,576 tokens บน OpenRouter และ output tokens สูงสุด 943,718 tokens แต่นั่นไม่ได้หมายความว่าคุณควรใช้ทั้งหมดในทุกคำขอ: input tokens บนโมเดลเหล่านี้มีราคาถูก แต่ output ขนาดยาวมีราคาสูง ดังนั้นควรจำกัด max_tokens ให้พอดีกับที่อินเทอร์เฟซของคุณสามารถแสดงผลได้

สำหรับระบบ agent แนะนำให้รักษา system prompt ให้คงที่และต่อท้ายบทสนทนาแทนการเขียนใหม่ทั้งหมด เพื่อให้ผู้ให้บริการที่มีระบบแคช prompt สามารถนำข้อมูลก่อนหน้ากลับมาใช้ซ้ำได้

ตั้งค่า stream: true สำหรับทุกงานที่มีผู้ใช้กำลังรอคำตอบอยู่
ลองส่งคำขอใหม่ (retry) สำหรับการตอบกลับรหัส 429, 502 และ 503 โดยเว้นช่วงเวลาสั้นๆ (backoff)
บันทึกข้อมูลการใช้งาน (usage) จาก chunk สุดท้ายเพื่อติดตามค่าใช้จ่ายของคุณ

§ 05คำถามที่พบบ่อย

คำถามเกี่ยวกับ GLM-5 API

Q01GLM-5 API สามารถใช้งานร่วมกับ OpenAI SDK ได้หรือไม่?

ได้ ทั้ง endpoint ของ Z.ai และ OpenRouter รองรับคำขอ chat completions ในรูปแบบเดียวกับ OpenAI เพียงกำหนด base URL ของ SDK ไปยังผู้ให้บริการและระบุชื่อโมเดล GLM

Q02โมเดล GLM-5 รุ่นใดมีค่าบริการถูกที่สุดในการเรียกใช้งาน?

GLM-5.3 Flash โดยบน OpenRouter มีราคาอยู่ที่ $0.0052 ต่อหนึ่งล้าน input tokens และ $0.1985 ต่อหนึ่งล้าน output tokens อีกทั้งยังรองรับการอ่านรูปภาพและวิดีโออีกด้วย

Q03model IDs ของ GLM-5.3 มีอะไรบ้าง?

บน OpenRouter: z-ai/glm-5.3, z-ai/glm-5.3-flash, z-ai/glm-5.3-flashx และ z-ai/glm-5.3-prime บนแพลตฟอร์มของ Z.ai: glm-5.3, glm-5.3-flash และ glm-5.3-flashx

Q04ฉันสามารถปิดการคิดวิเคราะห์ (reasoning) ได้ไหม?

GLM-5.3 จะใช้การคิดวิเคราะห์เสมอเมื่ออยู่บนแพลตฟอร์มของ Z.ai คุณสามารถทำให้คำตอบสั้นลงได้โดยตั้งค่า reasoning effort ให้อยู่ในระดับต่ำ ซึ่งเป็นค่าเริ่มต้นที่ระบบแชทฟรีของเราใช้งานอยู่

Q05มี GLM-5 API ให้ใช้ฟรีไหม?

เว็บไซต์นี้ไม่มีบริการ API สาธารณะ คุณสามารถทดลองใช้งาน GLM-5.3 และ GLM-5.3 Flash ได้ฟรีผ่านระบบเว็บแชทของเรา จากนั้นจึงเปลี่ยนไปใช้ Z.ai หรือ OpenRouter หากต้องการเชื่อมต่อผ่านโค้ดโปรแกรม

ลองใช้เลย

ถามคำถามจริงกับ GLM-5.3

ไม่ต้องมีบัญชี ไม่ต้องใช้บัตร ไม่ต้องติดตั้ง เพียงพิมพ์คำถามแล้วรับคำตอบจาก GLM-5.3 Flash ได้ในไม่กี่วินาที — สลับไปใช้ GLM-5.3 สำหรับโจทย์ที่ยากที่สุด

เปิดแชทฟรีมีการจำกัดการใช้งานฟรีรายวัน เพื่อให้ทุกคนสามารถเข้าใช้งานแชทได้อย่างทั่วถึง