กลับไปที่บล็อก

เริ่มต้นใช้งานคู่มือ

คำขอแรกไปยัง API ที่เข้ากันได้กับ OpenAI ใน Postman

ส่งคำขอ chat/completions จาก Postman ด้วย Bearer key ที่เก็บไว้ในตัวแปร แล้วอ่านคำตอบและฟิลด์ usage

โดย CheapTokens Teamเผยแพร่เมื่อ ใช้เวลาอ่าน 4 นาที

request body ใน Postman พร้อม model id และข้อความหนึ่งข้อความสำหรับ API ของ CheapTokens
ในหน้านี้
  1. ตั้งค่าในสี่ขั้นตอน
  2. กด Send แล้วอ่านคำตอบ
  3. คำขอแรกมีค่าใช้จ่ายเท่าไร
  4. หากมันไม่ทำงาน

คุณมี API key และต้องการดูว่าอะไรถูกส่งไปบนเครือข่ายจริง ๆ ก่อนที่คุณจะเขียนโค้ดสักบรรทัด Postman เหมาะกับสิ่งนี้โดยตรง: คุณกรอก URL, key และ JSON body กด Send แล้วคำตอบก็ปรากฏขึ้นด้านล่างทันที สำหรับ CheapTokens คำขอคือ POST https://api.cheaptokens.dev/v1/chat/completions พร้อม key Authorization: Bearer และ JSON body ที่ระบุชื่อโมเดล

ขั้นตอนด้านล่างอ้างอิงจากเอกสารของ Postman เอง (v12 ซึ่งเป็นเวอร์ชันล่าสุดบนเว็บไซต์เอกสาร ตรวจสอบเมื่อ 31 ตุลาคม 2026) หากคุณชอบใช้ terminal คำขอเดียวกันอยู่ใน คำขอ API แรกของคุณกับ CheapTokens

request body ใน Postman: model id, ข้อความผู้ใช้หนึ่งข้อความ, max_tokens
JSON body ดิบของคำขอแรก

ตั้งค่าในสี่ขั้นตอน#

คุณต้องการเพียงไม่กี่อย่าง: base URL, key ของคุณ, model id และข้อความหนึ่งข้อความ Postman เก็บสองอย่างแรกไว้ในตัวแปร ดังนั้น key จึงไม่ถูกวางลงในคำขอโดยตรง

เรียงลำดับ

จัดลำดับการตั้งค่า Postman

  1. กำหนดตัวแปร base_url และ api_key
  2. สร้าง HTTP request: POST ไปที่ {{base_url}}/chat/completions
  3. ในแท็บ Authorization เลือก Bearer Token และกรอก {{api_key}}
  4. ในแท็บ Body เลือก raw > JSON วาง body แล้วกด Send

รายละเอียดเล็กน้อยสำหรับแต่ละขั้นตอน

สร้างคำขอ คลิกไอคอน Add ในแถบด้านซ้ายแล้วเลือก HTTP เมนูแบบเลื่อนลงของ method มีค่าเริ่มต้นเป็น GET ดังนั้นเปลี่ยนเป็น POST แล้วกรอก URL ตัวแปรของ Postman เขียนเป็น {{variable_name}} เอกสารใช้ {{base_url}} เป็นตัวอย่าง กำหนด base_url เป็น https://api.cheaptokens.dev/v1 แล้วช่อง URL จะกลายเป็น {{base_url}}/chat/completions Postman เก็บตัวแปรเป็นสตริง ซึ่งไม่เป็นปัญหาในที่นี้

เพิ่ม key เปิดแท็บ Authorization เลือก Bearer Token ในเมนู Auth Type แล้วใส่ {{api_key}} ในช่อง Token Postman ส่งมันเป็น header Authorization ในรูปแบบ Bearer เอกสารแนะนำเช่นนี้เลย: เก็บ token ไว้ในตัวแปรแล้วอ้างอิงด้วยชื่อ เหตุผลที่นิสัยนี้สำคัญอยู่ใน เก็บ API key อย่างปลอดภัย

เขียน body ในแท็บ Body เลือก raw แล้วเลือก JSON ในเมนู สำหรับ raw body Postman ตั้งค่า Content-Type ที่ตรงกันให้เอง ดังนั้นคุณไม่ต้องเพิ่ม header นั้น วางสิ่งนี้:

json
{
  "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
  "messages": [
    { "role": "user", "content": "Explain in one sentence what a token is." }
  ],
  "max_tokens": 200
}

model id คือ gateway_id แบบเต็มจากเอกสาร CheapTokens ชื่อสั้นอย่าง deepseek-flash ไม่ได้รับการยอมรับ max_tokens จำกัดความยาวของคำตอบ ดังนั้นการทดสอบครั้งแรกจึงไม่ยืดเยื้อ รายละเอียด Postman อีกอย่าง: คอมเมนต์ // และ /* */ ใน JSON body จะถูกตัดออกก่อนส่ง ดังนั้นคุณจึงใส่คำอธิบายใน body ให้เพื่อนร่วมทีมได้

กด Send แล้วอ่านคำตอบ#

หากทุกอย่างถูกต้อง บานหน้าต่างคำตอบจะแสดง JSON object ในรูปแบบ OpenAI Chat Completions มีสองจุดที่สำคัญ:

  • choices[0].message.content คือข้อความคำตอบ
  • usage เก็บ prompt_tokens (สิ่งที่คุณส่งไป) และ completion_tokens (สิ่งที่โมเดลเขียน) นี่คือสิ่งที่คุณถูกเรียกเก็บเงิน ดังนั้นดูมันตั้งแต่คำขอแรกเลย

ตรวจสอบ choices[0].finish_reason ด้วย stop หมายความว่าโมเดลจบด้วยตัวเอง ส่วน length หมายความว่าคำตอบชน max_tokens และถูกตัด หากพบเช่นนั้น ให้เพิ่มขีดจำกัดหรืออ่าน คำตอบ AI ถูกตัด? แก้ finish_reason "length"

ลองก่อนเปิดคำตอบ:

ลองด้วยตัวเองลองดู: คุณตั้ง max_tokens เป็น 5 แล้วกด Send คุณคาดว่าจะเห็นอะไรใน finish_reason?แสดงคำตอบ

คุณจะได้ length: ห้า token ไม่พอสำหรับประโยคเต็ม คำตอบจึงถูกตัด ใส่ 200 กลับไปแล้วมันจะกลายเป็น stop

คำขอแรกมีค่าใช้จ่ายเท่าไร#

สมมติว่าคำขอข้างต้นใช้ input ประมาณ 30 token และคำตอบใช้ output ประมาณ 100 token (เป็นตัวอย่าง ไม่ใช่การวัดจริง ฟิลด์ usage ของคุณแสดงตัวเลขจริง) บน DeepSeek-V4-Flash นั่นคือ $0.00001 ตามราคาปัจจุบัน และราคาเท่ากันทุกชั่วโมง ราคาต่อ 1M token อยู่ในตารางสดบน หน้าราคา

คำขอ Postman เดียวกันสามารถลองโมเดลอื่นได้ เปลี่ยนเฉพาะบรรทัด model เช่นเป็น zai-org/GLM-5.3-Flash (context 390K, output สูงสุด 8,192 token) แล้วกด Send อีกครั้ง ยอดคงเหลือเดียวครอบคลุมทุกโมเดล ดังนั้นไม่มีอะไรเปลี่ยน: URL เดิม key เดิม

หากมันไม่ทำงาน#

Postman แสดงรหัสสถานะข้างคำตอบ เหล่านี้คือสาเหตุที่พบบ่อย:

จับคู่

จับคู่อาการกับสาเหตุ

  • 401 Unauthorizedkey หาย พิมพ์ผิด หรือ {{api_key}} ว่างเพราะตัวแปรยังไม่ได้กำหนด
  • 404 Not FoundURL ผิด: ตรวจสอบว่า base_url ลงท้ายด้วย /v1 และ path คือ /chat/completions
  • ข้อผิดพลาดที่กล่าวถึงโมเดลmodel id ถูกย่อ ให้ใช้ id แบบเต็มเช่น deepseek-ai/DeepSeek-V4-Flash-0731

มีสองเรื่องเฉพาะของ Postman ที่ควรตรวจสอบ หากคุณได้ 401 หรือ URL ดูผิด ให้ตรวจสอบว่า base_url และ api_key ถูกกำหนดใน environment ที่คุณเลือกไว้ และหาก key ดูถูกต้องแต่ยังได้ 401 ให้เปิดแท็บ Authorization อีกครั้ง: Auth Type ต้องเป็น Bearer Token ไม่ใช่ No Auth ข้อมูลเพิ่มเติมเกี่ยวกับรหัสเหล่านี้: ข้อผิดพลาด API 401 หรือ 404 ไม่แน่ใจว่าจะใช้ id ไหน? แสดงรายการโมเดลด้วย GET /v1/models คืนค่าทั้งหมด

เมื่อคุณพอใจแล้ว กด Save ตั้งชื่อคำขอและเลือก collection ครั้งต่อไปคุณเพียงแก้ฟิลด์ content หรือบรรทัด model เพื่อเปรียบเทียบคำตอบ เอกสารอ้างอิง API ฉบับเต็มอยู่ใน เอกสาร CheapTokens