Gemini API เกินโควตา (429 RESOURCE_EXHAUSTED)
Gemini API ส่ง 429 RESOURCE_EXHAUSTED เมื่อคุณเกินขีดจำกัดอัตราหรือโควตารายวัน ในระดับฟรี ขีดจำกัดมีค่าน้อย หน้านี้อธิบายข้อผิดพลาดแต่ละรูปแบบ ขีดจำกัดระดับฟรีปัจจุบัน และวิธีแก้ที่ได้ผล
โค้ด ชื่อโมเดล และป้ายกำกับของแคตตาล็อกสดจะแสดงเป็นภาษาอังกฤษ
ข้อผิดพลาดหน้าตาแบบไหน
ข้อผิดพลาดระดับฟรีทั่วไป ตามที่โพสต์ในฟอรัมนักพัฒนาของ Google มีส่วนประกอบดังนี้:
ตัวอย่าง 429 จากระดับฟรี
429 RESOURCE_EXHAUSTED
You exceeded your current quota, please check your plan and billing details.
Quota exceeded for metric: generativelanguage.googleapis.com/generate_content_free_tier_requests, limit: 50
quotaId: GenerateRequestsPerDayPerProjectPerModel-FreeTier
Please retry in 11.615098148s.quotaMetricบอกว่าอะไรหมดไปgenerate_content_free_tier_requestsนับคำขอในระดับฟรีquotaIdบอกช่วงเวลาPerDayคือโควตารายวัน ID ที่เป็นPerMinuteคือขีดจำกัดต่อนาทีlimitคือโควตาของคุณสำหรับโมเดลนั้นในช่วงเวลานั้นPlease retry inให้เวลารอที่ Google แนะนำ
รหัส 429 สามรหัสและ 403 หนึ่งรหัส
หน้าข้อผิดพลาดของ Google API ระบุรหัสข้อผิดพลาดสามรหัสที่มี HTTP 429 และ 403 ที่เกี่ยวข้อง:
| รหัส | HTTP | ความหมาย | วิธีแก้ |
|---|---|---|---|
rate_limit_exceeded | 429 | ถึงขีดจำกัดคำขอหรือโทเคนต่อนาทีหรือต่อวินาที | ลองใหม่ด้วยการรอแบบเพิ่มขึ้นเป็นทวีคูณ |
quota_exceeded | 429 | โควตารายวันถูกใช้หมดแล้ว | รอการรีเซ็ต หรือขอเพิ่มโควตา |
too_many_requests | 429 | คำขอมากเกินไปในช่วงเวลาสั้น ๆ | ลองใหม่ด้วยการรอแบบเพิ่มขึ้นเป็นทวีคูณ |
permission_denied | 403 | โปรเจกต์ถูกจำกัด หรือระดับฟรีใช้ไม่ได้กับโปรเจกต์นี้ | เชื่อมบัญชีการเรียกเก็บเงินและใช้ระดับแบบชำระเงิน |
ขีดจำกัดต่อนาทีจะหมดภายในหนึ่งนาที โควตารายวันจะหมดก็ต่อเมื่อรีเซ็ตเท่านั้น Google รีเซ็ตคำขอต่อวันเวลาเที่ยงคืนตามเวลาแปซิฟิก การลองใหม่กับข้อผิดพลาดโควตารายวันก่อนการรีเซ็ตทำให้คำขอสูญเปล่า
ขีดจำกัดระดับฟรีในขณะนี้
Google ใช้ขีดจำกัดกับแต่ละโปรเจกต์ Google Cloud ไม่ใช่แต่ละคีย์ ขีดจำกัดต่างกันสำหรับแต่ละโมเดล Google แสดงขีดจำกัดที่ใช้งานอยู่ของคุณใน AI Studio ตารางแสดงขีดจำกัดระดับฟรีของ Gemini และ Gemma ในแคตตาล็อก FreeLLMAPI
| โมเดล | ฟรีบน | ขนาดบริบท | ขีดจำกัดฟรี (ข้อเสนอที่ดีที่สุด) | เครื่องมือ | การอ่านภาพ |
|---|---|---|---|---|---|
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | ใช่ | ใช่ |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 คำขอ/นาที 20 คำขอ/วัน 250,000 โทเคน/นาที ~3M | ใช่ | ใช่ |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 คำขอ/นาที 20 คำขอ/วัน 250,000 โทเคน/นาที ~3M | ใช่ | ใช่ |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 คำขอ/นาที 20 คำขอ/วัน 250,000 โทเคน/นาที ~3M | ใช่ | ใช่ |
| Gemini 3.5 Flash | Google AI Studio | 1M | 10 คำขอ/นาที 20 คำขอ/วัน 250,000 โทเคน/นาที ~3M | ใช่ | ใช่ |
| Gemini 3.8 Live | Google AI Studio | - | 10 คำขอ/นาที 20 คำขอ/วัน 250,000 โทเคน/นาที ~3M | ใช่ | ใช่ |
| Gemini 3.8 Live Extended Thinking | Google AI Studio | - | 10 คำขอ/นาที 20 คำขอ/วัน 250,000 โทเคน/นาที ~3M | ใช่ | ใช่ |
| Gemini 3.8 Flash TTS | Google AI Studio | - | Ongoing AI Studio free-tier quota; account limits apply | ไม่ | ไม่ |
| Gemini 3.8 Flash-Lite TTS | Google AI Studio | - | Ongoing AI Studio free-tier quota; account limits apply | ไม่ | ไม่ |
| Gemini Robotics-ER 2 Preview | Google AI Studio | 131K | 10 คำขอ/นาที 20 คำขอ/วัน 250,000 โทเคน/นาที ~3M | ไม่ | ใช่ |
| Gemini 3.5 Flash Lite | Google AI Studio | 1M | 15 คำขอ/นาที 20 คำขอ/วัน 250,000 โทเคน/นาที ~3M | ใช่ | ใช่ |
| Gemini Flash Lite (latest alias) | Google AI Studio | - | 10 คำขอ/นาที 20 คำขอ/วัน 250,000 โทเคน/นาที ~3M | ใช่ | ใช่ |
แสดง 12 จาก 21 โมเดลฟรีที่ตรงกัน ดูโมเดลทั้งหมด.
ข้อมูลสดจากแคตตาล็อก FreeLLMAPI (เวอร์ชัน 2026.11.19 ตรวจสอบเมื่อ 2026-11-19) ขีดจำกัดฟรีเปลี่ยนบ่อย แคตตาล็อกถูกตรวจสอบทุกวัน
โมเดล Flash ส่วนใหญ่อนุญาตประมาณ 20 คำขอต่อวันในระดับฟรี โมเดล Gemma อนุญาตคำขอต่อวันมากกว่ามาก แต่มีหน้าต่างบริบทที่เล็กกว่า Google ระบุว่าขีดจำกัดที่ระบุไว้ไม่มีการรับประกัน และความจุจริงอาจแตกต่างกัน
วิธีแก้ที่ได้ผล
- อ่าน
quotaIdหากมีPerDayให้หยุดและรอการรีเซ็ตเวลาเที่ยงคืนตามเวลาแปซิฟิก - สำหรับขีดจำกัดต่อนาที ให้ลองใหม่ด้วยการรอแบบเพิ่มขึ้นเป็นทวีคูณและ jitter ตั้งจำนวนการลองใหม่สูงสุด
- ย้ายงานง่าย ๆ ไปยังโมเดลที่มีเพดานรายวันสูงกว่า เช่น โมเดล Gemma หรือ Flash-Lite
- ส่งโทเคนให้น้อยลง พรอมต์ยาวจะถึงขีดจำกัดต่อนาทีเร็ว
- อย่าตั้ง
max_tokensให้น้อยมาก Gemini Flash อาจใช้ thinking tokens ที่ซ่อนอยู่ภายในเพดานเอาต์พุต
| สิ่งที่คุณลอง | ช่วยได้ไหม | เหตุผล |
|---|---|---|
| สร้างคีย์ API ใหม่ในโปรเจกต์เดิม | ไม่ | ขีดจำกัดใช้กับโปรเจกต์ Google ระบุว่าคีย์ใหม่ไม่แก้ข้อผิดพลาด |
| อัปเกรดโปรเจกต์เป็นระดับแบบชำระเงิน | ให้โควตาแบบชำระเงิน | Google ระบุว่าระดับแบบชำระเงินไม่ให้โควตาระดับฟรี การใช้งานแบบชำระเงินจะถูกเรียกเก็บเงิน |
รอเวลา retry in | ได้ สำหรับขีดจำกัดต่อนาที | หน้าต่างต่อนาทีจะเริ่มใหม่ |
| เปลี่ยนไปใช้โมเดลอื่น | ได้ | แต่ละโมเดลมีโควตาของตัวเอง |
ตรวจสอบโควตาก่อนส่ง
คุณเห็นปัญหาได้ก่อนเกิดข้อผิดพลาด ใน AI Studio เปิดหน้าขีดจำกัดอัตราจากเอกสาร Gemini API หน้านี้แสดงขีดจำกัดที่ใช้งานอยู่ของโปรเจกต์คุณสำหรับแต่ละโมเดล หน้า Projects แสดงระดับของคุณ
หากคุณใช้ FreeLLMAPI ให้ถามเกตเวย์ว่าโมเดลใดพร้อมใช้งานตอนนี้ โมเดลที่มีสถานะ exhausted มีคีย์ที่ทั้งหมดอยู่ในช่วงพัก สถานะนี้จะหายไปเองเมื่อช่วงพักสิ้นสุด
แสดงรายการโมเดลที่ตอบได้ตอนนี้
curl "http://localhost:3001/v1/models?execution_status=ready" \
-H "Authorization: Bearer <unified-key>"วางแผนการใช้งานรายวันด้วยตัวเลขง่าย ๆ ที่ 20 คำขอต่อวัน โมเดล Flash หนึ่งตัวให้คำขอประมาณหนึ่งรายการทุก 72 นาทีตลอดทั้งวัน เอเจนต์เขียนโค้ดอาจใช้ 20 คำขอสำหรับงานเดียว ให้ใช้โมเดล Flash เฉพาะงานยาก และส่งงานง่ายไปยังโมเดลที่มีเพดานรายวันสูงกว่า
สลับไปยังผู้ให้บริการฟรีรายอื่น
ด้วยประมาณ 20 คำขอ Flash ต่อวัน คีย์ Gemini เพียงคีย์เดียวไม่พอสำหรับงานเอเจนต์ FreeLLMAPI วาง Gemini ไว้หลัง endpoint เดียวร่วมกับผู้ให้บริการฟรีรายอื่น เมื่อ Gemini ส่ง 429 เราเตอร์จะส่งคำขอไปยังโมเดลถัดไปในห่วงโซ่ของคุณ
- เราเตอร์นับ RPM, RPD, TPM และ TPD สำหรับแต่ละโมเดลและคีย์ มันหยุดก่อนถึงขีดจำกัดที่รู้จัก
- 429 แบบสั้นทำให้คีย์อยู่ในช่วงพัก 90 วินาที โควตารายวันที่หมดทั้งหมดใช้ช่วงพักที่นานกว่า: 2 นาที, 10 นาที, 1 ชั่วโมง แล้วจึง 24 ชั่วโมง
- หาก Google ให้เวลาลองใหม่ที่นานกว่า เราเตอร์จะใช้ค่าของ Google
- header
X-Fallback-Trailแสดงทุกการกระโดดที่ล้มเหลว เช่นgoogle/gemini-2.5-flash key1=rate_limited
ส่งทราฟฟิก Gemini ผ่านเกตเวย์
curl -fsSL https://freellmapi.co/install.sh | bash
curl -i http://localhost:3001/v1/chat/completions \
-H "Authorization: Bearer <unified-key>" \
-H "Content-Type: application/json" \
-d '{"model": "auto", "messages": [{"role": "user", "content": "hi"}]}'Gemini CLI ยังใช้พื้นผิว /v1beta แบบเนทีฟของเกตเวย์ได้ เกตเวย์ไม่เพิ่มโควตา Gemini เมื่อ Gemini ถึงขีดจำกัด มันใช้ผู้ให้บริการอื่นแทน
ข้อจำกัดเฉพาะของ Gemini
| ผู้ให้บริการ | ปัญหาที่ทราบ | สิ่งที่ควรทำ |
|---|---|---|
| Google AI Studio | Thinking tokens use output cap | Gemini Flash can spend hidden thinking tokens inside maxOutputTokens. Avoid tiny max_tokens values or set thinkingBudget to 0 when provider support is available. |
ข้อมูลสดจากแคตตาล็อก FreeLLMAPI (เวอร์ชัน 2026.11.19 ตรวจสอบเมื่อ 2026-11-19) ขีดจำกัดฟรีเปลี่ยนบ่อย แคตตาล็อกถูกตรวจสอบทุกวัน
คำถามที่พบบ่อย
429 RESOURCE_EXHAUSTED หมายความว่าอะไรใน Gemini API
หมายความว่าโปรเจกต์ของคุณเกินขีดจำกัดอัตราหรือโควตา quotaId ในเนื้อหาข้อผิดพลาดบอกว่าเป็นขีดจำกัดต่อนาทีหรือโควตารายวัน
โควตาระดับฟรีของ Gemini รีเซ็ตเมื่อไร
คำขอต่อวันรีเซ็ตเวลาเที่ยงคืนตามเวลาแปซิฟิก ขีดจำกัดต่อนาทีรีเซ็ตภายในหนึ่งนาที
ทำไมคีย์ Gemini API ใหม่ไม่แก้ข้อผิดพลาดโควตา
Google ใช้ขีดจำกัดกับโปรเจกต์ Google Cloud ไม่ใช่กับคีย์ ทุกคีย์ในโปรเจกต์เดียวกันใช้โควตาเดียวกัน
limit: 0 ในข้อผิดพลาดโควตา Gemini หมายความว่าอะไร
หมายความว่าโปรเจกต์ของคุณไม่มีโควตาฟรีสำหรับโมเดลนั้นในช่วงเวลานั้น บางโปรเจกต์ไม่มีสิทธิ์ใช้ระดับฟรี ตรวจสอบขีดจำกัดของคุณใน AI Studio หรือลองโมเดลอื่น
ฉันจะหลีกเลี่ยงข้อผิดพลาด 429 ของ Gemini ในเอเจนต์เขียนโค้ดได้อย่างไร
ใช้ผู้ให้บริการฟรีหลายรายหลังเกตเวย์เดียว เมื่อ Gemini ถึงขีดจำกัด เกตเวย์จะส่งคำขอไปยังผู้ให้บริการอีกราย เอเจนต์จึงทำงานต่อได้
คู่มือที่เกี่ยวข้อง
- Rate limit ของ Free LLM API
- free gemini api
- Gemini CLI กับ custom endpoint และโมเดลฟรี
- Groq ถึงขีดจำกัดอัตรา (429)
- NVIDIA NIM API rate limit
แหล่งข้อมูล
- Google AI Studio: Rate limits (ตรวจสอบเมื่อ 20 November 2026)
- Google AI Studio: API errors (ตรวจสอบเมื่อ 20 November 2026)
- Google AI Studio: Troubleshooting (ตรวจสอบเมื่อ 20 November 2026)
- Google developer forum: free tier quota error example (ตรวจสอบเมื่อ 20 November 2026)
- FreeLLMAPI docs: Quota and cooldown engine (ตรวจสอบเมื่อ 20 November 2026)
- FreeLLMAPI docs: Response headers (ตรวจสอบเมื่อ 20 November 2026)