Gemini API เจอ 429 หรือ 503 แก้อย่างไร แยกโควตาเต็มกับระบบไม่พร้อม

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

ซองคำขอเว้นระยะเข้าคิวข้างนาฬิกาทราย สื่อถึงการรอและลองเรียก API ใหม่อย่างมีขอบเขต

แยกสาเหตุและวิธีรับมือของ 429 กับ 503

429 โดยทั่วไปหมายถึงคำขอชนข้อจำกัดอัตราการใช้งานหรือโควตาที่ใช้ได้ ขณะที่ 503 มักบ่งบอกว่าบริการไม่พร้อมหรือมีภาระสูงชั่วคราว เอกสาร Google แนะนำให้ใช้การลองใหม่แบบ exponential backoff กับข้อผิดพลาดชั่วคราว แต่ต้องแยกจากข้อผิดพลาดคำขอที่แก้ด้วยการรอไม่ได้ (Troubleshooting; ตรวจสอบ 16 ตุลาคม 2569)

สถานะความหมายที่ควรตรวจแนวทางเบื้องต้น
400คำขอหรือพารามิเตอร์ไม่ถูกต้องตรวจชื่อโมเดล เวอร์ชัน API และรูปแบบข้อมูล ไม่ส่งซ้ำแบบเดิม
429Rate limit, โควตา หรือเพดานอัตราการใช้จ่ายอ่านรายละเอียด error ตรวจ Usage และ Rate Limits แล้วกำหนดเวลาลองใหม่ให้เหมาะ
503บริการไม่พร้อมชั่วคราวลองใหม่แบบหน่วงเวลาและจำกัดจำนวนครั้ง
5xx อื่นปัญหาฝั่งบริการที่อาจชั่วคราวบันทึกสถานะ ตรวจเอกสาร และลองใหม่อย่างระมัดระวัง

หมายเหตุ: รายละเอียด error ของ API แต่ละรูปแบบอาจต่างกัน ให้ยึดสถานะ HTTP และข้อมูล error ที่ตอบกลับจริงร่วมกับ คู่มือ API errors ไม่ตัดสินจากข้อความแจ้งเตือนสั้น ๆ เพียงบรรทัดเดียว

ทำไม Gemini ตอบ 429 ทั้งที่ใช้โควตาไปไม่มาก

โควตาใช้ร่วมกันในระดับโปรเจกต์ การเพิ่ม API key ในโปรเจกต์เดิมจึงไม่ได้เพิ่มโควตาอีกชุด ข้อจำกัดไม่ได้มีเพียงจำนวนคำขอต่อวัน แต่ยังเกี่ยวข้องกับอัตราคำขอและโทเค็นตามโมเดล ระดับบัญชี และฟีเจอร์ที่เปิดใช้ เช่น งาน Batch มีข้อจำกัดแยกจากงานปกติ ดังนั้นการนับจำนวนครั้งด้วยตนเองอาจไม่ตรงกับข้อจำกัดที่ระบบกำลังใช้ (Rate limits)

  1. เปิด Google AI Studio แล้วเลือกโปรเจกต์ที่แอปเรียกจริง
  2. ดู Usage และ Rate Limits สำหรับโมเดลและช่วงเวลาที่เกิดปัญหา
  3. ตรวจว่ามีคำขอพร้อมกันจำนวนมากจากผู้ใช้หลายคนหรือจากงานเบื้องหลังหรือไม่
  4. ดูรายละเอียด error ว่าพูดถึงอัตราต่อนาที โควตารายวัน หรือข้อจำกัดอื่น
  5. ตรวจสถานะ 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 ไม่ได้

ก่อนเปิดแอปให้คนใช้จริง ควรมีอะไร

บันทึกเวลา โมเดล รหัสสถานะ และรหัสคำขอ โดยเก็บ API key และข้อความส่วนตัวออกจาก log จำกัดคำขอที่ทำพร้อมกัน และกำหนด timeout พร้อมข้อความบอกผู้ใช้ว่าระบบกำลังรอหรือหยุดแล้ว หลังกลับมาใช้งานได้ ให้ตรวจทั้งค่าใช้จ่ายและคำตอบ เพราะคำขอที่สำเร็จยังอาจให้ข้อมูลผิด

แหล่งอ้างอิง

ตรวจเอกสาร Google วันที่ 16 ตุลาคม 2569 ตัวอย่างเวลารอเป็นสมมติฐาน ไม่ใช่ค่าบังคับของ Google ไม่ได้ทดสอบโหลดหรือเรียก API จริงในบทความนี้