Gemini API เจอ 429 หรือ 503 แก้อย่างไร แยกโควตาเต็มกับระบบไม่พร้อม
แอปที่เรียก Gemini API อยู่ดี ๆ ได้ 429 หรือ 503 ควรกดส่งใหม่ทันทีหรือเปลี่ยนโมเดล? ถ้าแก้ผิดทาง อาจทำให้คำขอสะสม ต้นทุนเพิ่ม และผู้ใช้เห็นผลลัพธ์ซ้ำ

แยกสาเหตุและวิธีรับมือของ 429 กับ 503
429 โดยทั่วไปหมายถึงคำขอชนข้อจำกัดอัตราการใช้งานหรือโควตาที่ใช้ได้ ขณะที่ 503 มักบ่งบอกว่าบริการไม่พร้อมหรือมีภาระสูงชั่วคราว เอกสาร Google แนะนำให้ใช้การลองใหม่แบบ exponential backoff กับข้อผิดพลาดชั่วคราว แต่ต้องแยกจากข้อผิดพลาดคำขอที่แก้ด้วยการรอไม่ได้ (Troubleshooting; ตรวจสอบ 16 ตุลาคม 2569)
| สถานะ | ความหมายที่ควรตรวจ | แนวทางเบื้องต้น |
|---|---|---|
| 400 | คำขอหรือพารามิเตอร์ไม่ถูกต้อง | ตรวจชื่อโมเดล เวอร์ชัน API และรูปแบบข้อมูล ไม่ส่งซ้ำแบบเดิม |
| 429 | Rate limit, โควตา หรือเพดานอัตราการใช้จ่าย | อ่านรายละเอียด error ตรวจ Usage และ Rate Limits แล้วกำหนดเวลาลองใหม่ให้เหมาะ |
| 503 | บริการไม่พร้อมชั่วคราว | ลองใหม่แบบหน่วงเวลาและจำกัดจำนวนครั้ง |
| 5xx อื่น | ปัญหาฝั่งบริการที่อาจชั่วคราว | บันทึกสถานะ ตรวจเอกสาร และลองใหม่อย่างระมัดระวัง |
หมายเหตุ: รายละเอียด error ของ API แต่ละรูปแบบอาจต่างกัน ให้ยึดสถานะ HTTP และข้อมูล error ที่ตอบกลับจริงร่วมกับ คู่มือ API errors ไม่ตัดสินจากข้อความแจ้งเตือนสั้น ๆ เพียงบรรทัดเดียว
ทำไม Gemini ตอบ 429 ทั้งที่ใช้โควตาไปไม่มาก
โควตาใช้ร่วมกันในระดับโปรเจกต์ การเพิ่ม API key ในโปรเจกต์เดิมจึงไม่ได้เพิ่มโควตาอีกชุด ข้อจำกัดไม่ได้มีเพียงจำนวนคำขอต่อวัน แต่ยังเกี่ยวข้องกับอัตราคำขอและโทเค็นตามโมเดล ระดับบัญชี และฟีเจอร์ที่เปิดใช้ เช่น งาน Batch มีข้อจำกัดแยกจากงานปกติ ดังนั้นการนับจำนวนครั้งด้วยตนเองอาจไม่ตรงกับข้อจำกัดที่ระบบกำลังใช้ (Rate limits)
- เปิด Google AI Studio แล้วเลือกโปรเจกต์ที่แอปเรียกจริง
- ดู Usage และ Rate Limits สำหรับโมเดลและช่วงเวลาที่เกิดปัญหา
- ตรวจว่ามีคำขอพร้อมกันจำนวนมากจากผู้ใช้หลายคนหรือจากงานเบื้องหลังหรือไม่
- ดูรายละเอียด error ว่าพูดถึงอัตราต่อนาที โควตารายวัน หรือข้อจำกัดอื่น
- ตรวจสถานะ Billing และการใช้จ่ายเมื่อเกี่ยวข้อง โดยไม่สมมติว่าการจ่ายเงินทำให้ไร้ข้อจำกัด
ตรวจเวลารีเซ็ตด้วย: เอกสาร Google ระบุว่าโควตาคำขอต่อวัน (RPD) รีเซ็ตเมื่อเที่ยงคืนตามเวลา Pacific จึงไม่ควรตีความว่าเป็นเที่ยงคืนในประเทศไทย
ตัวอย่างสมมติ: เว้นช่วงและจำกัดจำนวนครั้งที่ลองใหม่
สมมติว่าคำขออ่านข้อมูลได้รับ 503 และระบบตั้งให้ลองใหม่ไม่เกิน 3 ครั้ง โดยรอประมาณ 1, 2 และ 4 วินาทีตามลำดับ พร้อมสุ่มเวลารอเพิ่มเล็กน้อย (jitter) เพื่อไม่ให้ผู้ใช้จำนวนมากส่งซ้ำพร้อมกัน 1, 2 และ 4 วินาทีเป็นตัวอย่างการออกแบบ ไม่ใช่ค่าบังคับของ Google หากบริการตอบคำแนะนำเวลารอหรือ SDK จัดการ retry ให้อยู่แล้ว ควรใช้ข้อมูลนั้นและหลีกเลี่ยงการ retry ซ้อนกัน
หลักการคือ delay(n) = min(เวลารอสูงสุด, เวลารอเริ่มต้น × 2^n + jitter) โดย n เริ่มที่ 0 ตั้งเวลาสูงสุดและจำนวนครั้งสูงสุดเสมอ เมื่อครบแล้วให้แสดงข้อความว่าไม่สำเร็จ แทนการรอไม่สิ้นสุด
หากคำขอของแอปเกี่ยวข้องกับการบันทึกข้อมูลหรือทำธุรกรรม ไม่ควรลองซ้ำโดยไม่ตรวจว่ารอบแรกทำงานสำเร็จไปแล้วหรือไม่ ควรออกแบบรหัสคำขอและกลไกป้องกันการทำงานซ้ำก่อน
เมื่อไรส่งคำขอซ้ำแล้วแก้ 429 หรือ 503 ไม่ได้
- 400 จาก JSON หรือพารามิเตอร์ผิด: ต้องแก้คำขอ
- สิทธิ์หรือ API Key ผิด: ต้องตรวจการตั้งค่า ไม่ใช่ส่งใหม่เรื่อย ๆ
- โควตาที่ต้องรอรอบรีเซ็ตหรือปรับระดับบริการ: การหน่วงเพียงไม่กี่วินาทีอาจไม่พอ
- ผลลัพธ์ถูกบล็อกด้วยนโยบายหรือข้อจำกัดเนื้อหา: ไม่ควรใช้ retry เพื่อหลีกเลี่ยงการตรวจดังกล่าว
ก่อนเปิดแอปให้คนใช้จริง ควรมีอะไร
บันทึกเวลา โมเดล รหัสสถานะ และรหัสคำขอ โดยเก็บ API key และข้อความส่วนตัวออกจาก log จำกัดคำขอที่ทำพร้อมกัน และกำหนด timeout พร้อมข้อความบอกผู้ใช้ว่าระบบกำลังรอหรือหยุดแล้ว หลังกลับมาใช้งานได้ ให้ตรวจทั้งค่าใช้จ่ายและคำตอบ เพราะคำขอที่สำเร็จยังอาจให้ข้อมูลผิด
แหล่งอ้างอิง
- Google AI for Developers: Troubleshooting guide
- Google AI for Developers: Rate limits
- Google AI for Developers: API errors
- Google: Retry strategy
- Google Site Policies
ตรวจเอกสาร Google วันที่ 16 ตุลาคม 2569 ตัวอย่างเวลารอเป็นสมมติฐาน ไม่ใช่ค่าบังคับของ Google ไม่ได้ทดสอบโหลดหรือเรียก API จริงในบทความนี้