รหัสข้อผิดพลาด
401 / 403 / 404 / 429 / 5xx หมายถึงอะไร ขั้นตอนแก้ไข 5 ขั้น และแนวปฏิบัติที่ช่วยลดข้อผิดพลาด
เมื่อการเรียกล้มเหลว ให้เริ่มจากรหัสสถานะ HTTP และข้อความข้อผิดพลาดในเนื้อหาการตอบกลับ แล้วเทียบกับตารางด้านล่าง ปัญหาส่วนใหญ่แก้ได้ด้วยสามข้อแรก
รหัสสถานะ
| สถานะ | ความหมาย | สาเหตุและวิธีแก้ที่พบบ่อย |
|---|---|---|
| 400 Bad Request | คำขอไม่ถูกต้อง | JSON ผิดรูปแบบ หรือขาดฟิลด์บังคับ (model, messages) ตรวจสอบเนื้อหาคำขอเทียบกับเอกสาร API |
| 401 Unauthorized | ยืนยันตัวตนไม่สำเร็จ | คีย์ผิด / ถูกลบ / หมดอายุ ดูรายการตรวจสอบในการยืนยันตัวตน |
| 403 Forbidden | ไม่มีสิทธิ์เข้าถึง | คีย์หรือบัญชีนี้อาจไม่ได้รับอนุญาตให้เรียกโมเดลที่ขอ ตรวจสอบในตลาดโมเดลว่าโมเดลนั้นใช้งานได้กับคุณ |
| 404 Not Found | ไม่พบทรัพยากร | มักเกิดจากสะกด ID โมเดลผิด ให้คัดลอก ID ที่ถูกต้องจากตลาดโมเดล |
| 429 Too Many Requests | ถูกจำกัดอัตราการเรียกใช้ | มีคำขอถี่เกินไป ให้ถอยระยะห่าง (แบบทวีคูณ) หรือลดจำนวนคำขอพร้อมกัน หากยังเป็นต่อเนื่องให้ติดต่อแพลตฟอร์ม |
| 5xx | ข้อผิดพลาดฝั่งเซิร์ฟเวอร์ | แพลตฟอร์มหรือโมเดลต้นทางขัดข้องชั่วคราว ลองใหม่หนึ่งครั้งด้วยพารามิเตอร์เดิม หากยังล้มเหลวให้ติดต่อฝ่ายสนับสนุนพร้อมบันทึกคำขอจากหน้าบันทึกการใช้งาน |
ขั้นตอนการแก้ไขปัญหา
- ตรวจสอบคีย์: ยืนยันในหน้า "คีย์ API" ว่าคีย์ยังอยู่และยังไม่หมดอายุ หากไม่แน่ใจให้ลบแล้วสร้างใหม่
- ตรวจสอบ ID โมเดล: คัดลอกจากตลาดโมเดลแทนการพิมพ์เอง
- อ่านเนื้อหาข้อผิดพลาด: การตอบกลับที่ผิดพลาดมักมี
error.messageที่อธิบายสาเหตุที่แท้จริง (ยอดคงเหลือไม่พอ ขาดพารามิเตอร์ ฯลฯ) - ตรวจสอบบันทึก: หน้าบันทึกในคอนโซลแสดงสถานะ เวลาตอบสนอง และปริมาณการใช้ของแต่ละคำขอ ตรวจดูว่าความล้มเหลวจำกัดอยู่ที่โมเดลหรือคีย์ใดคีย์หนึ่งหรือไม่
- ยังแก้ไม่ได้: ติดต่อฝ่ายสนับสนุนพร้อมเวลาและรหัสสถานะจากหน้าบันทึก
แนวปฏิบัติที่ช่วยลดข้อผิดพลาด
- ใช้ SDK อย่างเป็นทางการ (จัดการการลองใหม่ การหมดเวลา และรายละเอียดโปรโตคอลให้แล้ว)
- ใช้การถอยระยะห่างแบบทวีคูณกับ 429 / 5xx แทนการลองใหม่รัว ๆ
- ตั้งวงเงินการใช้จ่ายให้คีย์ในโปรดักชัน เพื่อไม่ให้ปริมาณการใช้งานที่ผิดปกติกัดยอดคงเหลือจนหมด