Gemini API vượt hạn mức (429 RESOURCE_EXHAUSTED)
Gemini API trả về 429 RESOURCE_EXHAUSTED khi bạn vượt giới hạn tốc độ hoặc hạn mức hằng ngày. Ở gói miễn phí, các giới hạn này nhỏ. Trang này giải thích từng dạng lỗi, giới hạn miễn phí hiện tại và các cách sửa hiệu quả.
Mã, tên mô hình và nhãn danh mục trực tiếp được hiển thị bằng tiếng Anh.
Lỗi trông như thế nào
Một lỗi điển hình ở gói miễn phí, như đăng trên diễn đàn nhà phát triển của Google, có các phần sau:
Ví dụ 429 từ gói miễn phí
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.quotaMetriccho biết thứ gì đã cạn.generate_content_free_tier_requestsđếm yêu cầu ở gói miễn phí.quotaIdcho biết khoảng thời gian.PerDaylà hạn mức hằng ngày. Một idPerMinutelà giới hạn theo phút.limitlà hạn mức của bạn cho mô hình đó trong khoảng thời gian đó.Please retry incho biết thời gian chờ mà Google đề nghị.
Ba mã 429 và một mã 403
Trang lỗi API của Google liệt kê ba mã lỗi với HTTP 429, và một mã 403 liên quan:
| Mã | HTTP | Ý nghĩa | Cách sửa |
|---|---|---|---|
rate_limit_exceeded | 429 | Đã chạm giới hạn yêu cầu hoặc token theo phút hoặc theo giây | Thử lại với thời gian chờ tăng dần |
quota_exceeded | 429 | Đã dùng hết hạn mức hằng ngày | Chờ đến lúc đặt lại, hoặc yêu cầu tăng hạn mức |
too_many_requests | 429 | Quá nhiều yêu cầu trong khoảng thời gian ngắn | Thử lại với thời gian chờ tăng dần |
permission_denied | 403 | Dự án bị hạn chế, hoặc gói miễn phí không khả dụng cho dự án đó | Liên kết tài khoản thanh toán và dùng gói trả phí |
Giới hạn theo phút hết hiệu lực trong chưa đầy một phút. Hạn mức hằng ngày chỉ hết hiệu lực khi đặt lại. Google đặt lại yêu cầu mỗi ngày vào nửa đêm giờ Thái Bình Dương. Thử lại lỗi hạn mức hằng ngày trước khi đặt lại sẽ lãng phí yêu cầu.
Giới hạn gói miễn phí hiện nay
Google áp dụng giới hạn cho từng dự án Google Cloud, không cho từng khóa. Giới hạn khác nhau cho từng mô hình. Google hiển thị giới hạn đang hoạt động của bạn trong AI Studio. Bảng cho thấy giới hạn miễn phí của Gemini và Gemma trong danh mục FreeLLMAPI.
| Mô hình | Miễn phí trên | Ngữ cảnh | Giới hạn miễn phí (ưu đãi tốt nhất) | Công cụ | Thị giác |
|---|---|---|---|---|---|
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Có | Có |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 yêu cầu/phút 20 yêu cầu/ngày 250,000 token/phút ~3M | Có | Có |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 yêu cầu/phút 20 yêu cầu/ngày 250,000 token/phút ~3M | Có | Có |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 yêu cầu/phút 20 yêu cầu/ngày 250,000 token/phút ~3M | Có | Có |
| Gemini 3.5 Flash | Google AI Studio | 1M | 10 yêu cầu/phút 20 yêu cầu/ngày 250,000 token/phút ~3M | Có | Có |
| Gemini 3.8 Live | Google AI Studio | - | 10 yêu cầu/phút 20 yêu cầu/ngày 250,000 token/phút ~3M | Có | Có |
| Gemini 3.8 Live Extended Thinking | Google AI Studio | - | 10 yêu cầu/phút 20 yêu cầu/ngày 250,000 token/phút ~3M | Có | Có |
| Gemini 3.8 Flash TTS | Google AI Studio | - | Ongoing AI Studio free-tier quota; account limits apply | Không | Không |
| Gemini 3.8 Flash-Lite TTS | Google AI Studio | - | Ongoing AI Studio free-tier quota; account limits apply | Không | Không |
| Gemini Robotics-ER 2 Preview | Google AI Studio | 131K | 10 yêu cầu/phút 20 yêu cầu/ngày 250,000 token/phút ~3M | Không | Có |
| Gemini 3.5 Flash Lite | Google AI Studio | 1M | 15 yêu cầu/phút 20 yêu cầu/ngày 250,000 token/phút ~3M | Có | Có |
| Gemini Flash Lite (latest alias) | Google AI Studio | - | 10 yêu cầu/phút 20 yêu cầu/ngày 250,000 token/phút ~3M | Có | Có |
Đang hiển thị 12 trong số 21 mô hình miễn phí phù hợp. Xem tất cả mô hình.
Dữ liệu trực tiếp từ danh mục FreeLLMAPI (phiên bản 2026.11.19, đã kiểm tra 2026-11-19). Giới hạn miễn phí thay đổi thường xuyên. Danh mục được kiểm tra mỗi ngày.
Hầu hết mô hình Flash cho khoảng 20 yêu cầu mỗi ngày ở gói miễn phí. Mô hình Gemma cho nhiều yêu cầu hơn mỗi ngày, nhưng có cửa sổ ngữ cảnh nhỏ hơn. Google nói rằng giới hạn được nêu không được đảm bảo và dung lượng thực tế có thể thay đổi.
Các cách sửa hiệu quả
- Đọc
quotaId. Nếu cóPerDay, dừng lại và chờ đến lúc đặt lại vào nửa đêm giờ Thái Bình Dương. - Với giới hạn theo phút, thử lại với thời gian chờ tăng dần và jitter. Đặt số lần thử lại tối đa.
- Chuyển tác vụ đơn giản sang mô hình có mức trần hằng ngày cao hơn, ví dụ mô hình Gemma hoặc Flash-Lite.
- Gửi ít token hơn. Prompt lớn nhanh chóng chạm giới hạn token mỗi phút.
- Không đặt
max_tokensquá nhỏ. Gemini Flash có thể dùng token suy luận ẩn bên trong giới hạn đầu ra.
| Điều bạn thử | Có hữu ích không? | Lý do |
|---|---|---|
| Tạo khóa API mới trong cùng dự án | Không | Giới hạn áp dụng cho dự án. Google nói khóa mới không giải quyết được lỗi. |
| Nâng cấp dự án lên gói trả phí | Cung cấp hạn mức trả phí | Google nói gói trả phí không cấp hạn mức gói miễn phí cho bạn. Việc dùng trả phí được tính phí. |
Chờ đến thời gian retry in | Có, với giới hạn theo phút | Cửa sổ phút được làm mới |
| Đổi sang mô hình khác | Có | Mỗi mô hình có hạn mức riêng |
Kiểm tra hạn mức trước khi gửi
Bạn có thể thấy vấn đề trước khi xảy ra lỗi. Trong AI Studio, mở trang giới hạn tốc độ từ tài liệu Gemini API. Trang này hiển thị giới hạn đang hoạt động của dự án bạn cho từng mô hình. Trang Projects hiển thị hạng của bạn.
Nếu bạn dùng FreeLLMAPI, hỏi cổng xem mô hình nào sẵn sàng ngay bây giờ. Mô hình có trạng thái exhausted nghĩa là mọi khóa của nó đều đang trong thời gian nghỉ. Trạng thái này tự mất khi thời gian nghỉ kết thúc.
Liệt kê các mô hình có thể trả lời ngay
curl "http://localhost:3001/v1/models?execution_status=ready" \
-H "Authorization: Bearer <unified-key>"Lập kế hoạch dùng hằng ngày bằng các con số đơn giản. Với 20 yêu cầu mỗi ngày, một mô hình Flash cho bạn khoảng một yêu cầu mỗi 72 phút trong cả ngày. Một tác nhân lập trình có thể dùng 20 yêu cầu cho một tác vụ. Chỉ dùng mô hình Flash cho tác vụ khó, và gửi tác vụ đơn giản tới mô hình có mức trần hằng ngày lớn hơn.
Chuyển sang nhà cung cấp miễn phí khác
Với khoảng 20 yêu cầu Flash mỗi ngày, một khóa Gemini không đủ cho công việc của tác nhân. FreeLLMAPI đặt Gemini sau một endpoint cùng với các nhà cung cấp miễn phí khác. Khi Gemini gửi lỗi 429, bộ định tuyến gửi yêu cầu tới mô hình tiếp theo trong chuỗi của bạn.
- Bộ định tuyến đếm RPM, RPD, TPM và TPD cho từng mô hình và khóa. Nó dừng trước khi chạm một giới hạn đã biết.
- Lỗi 429 ngắn đặt khóa vào thời gian nghỉ 90 giây. Hạn mức hằng ngày đã hết dùng thời gian nghỉ dài hơn: 2 phút, 10 phút, 1 giờ, rồi 24 giờ.
- Nếu Google đưa ra thời gian thử lại dài hơn, bộ định tuyến dùng giá trị của Google.
- Tiêu đề
X-Fallback-Trailliệt kê từng bước thất bại, ví dụgoogle/gemini-2.5-flash key1=rate_limited.
Gửi lưu lượng Gemini qua cổng
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 cũng có thể dùng bề mặt /v1beta gốc của cổng. Cổng không thêm hạn mức Gemini. Nó dùng nhà cung cấp khác khi Gemini đạt giới hạn.
Các điểm bất thường đã biết của Gemini
| Nhà cung cấp | Vấn đề đã biết | Cách xử lý |
|---|---|---|
| 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. |
Dữ liệu trực tiếp từ danh mục FreeLLMAPI (phiên bản 2026.11.19, đã kiểm tra 2026-11-19). Giới hạn miễn phí thay đổi thường xuyên. Danh mục được kiểm tra mỗi ngày.
Câu hỏi thường gặp
RESOURCE_EXHAUSTED 429 nghĩa là gì trong Gemini API?
Nghĩa là dự án của bạn đã vượt giới hạn tốc độ hoặc hạn mức. quotaId trong nội dung lỗi cho biết đó là giới hạn theo phút hay hạn mức hằng ngày.
Hạn mức gói miễn phí của Gemini đặt lại khi nào?
Yêu cầu mỗi ngày đặt lại vào nửa đêm giờ Thái Bình Dương. Giới hạn theo phút đặt lại trong vòng một phút.
Vì sao khóa API Gemini mới không sửa được lỗi hạn mức?
Google áp dụng giới hạn cho dự án Google Cloud, không cho khóa. Mọi khóa trong cùng dự án đều dùng chung hạn mức.
limit: 0 trong lỗi hạn mức Gemini nghĩa là gì?
Nghĩa là dự án của bạn không có hạn mức miễn phí cho mô hình đó trong khoảng thời gian đó. Một số dự án không đủ điều kiện dùng gói miễn phí. Kiểm tra giới hạn trong AI Studio hoặc thử mô hình khác.
Làm sao tránh lỗi 429 của Gemini trong tác nhân lập trình?
Dùng nhiều nhà cung cấp miễn phí sau một cổng. Khi Gemini đạt giới hạn, cổng gửi yêu cầu tới nhà cung cấp khác, nên tác nhân tiếp tục chạy.
Hướng dẫn liên quan
- Giới hạn tốc độ API LLM miễn phí
- free gemini api
- Gemini CLI với endpoint tùy chỉnh và mô hình miễn phí
- Groq đạt giới hạn tốc độ (429)
- Giới hạn tốc độ API NVIDIA NIM
Nguồn
- Google AI Studio: Rate limits (đã kiểm tra 20 November 2026)
- Google AI Studio: API errors (đã kiểm tra 20 November 2026)
- Google AI Studio: Troubleshooting (đã kiểm tra 20 November 2026)
- Google developer forum: free tier quota error example (đã kiểm tra 20 November 2026)
- FreeLLMAPI docs: Quota and cooldown engine (đã kiểm tra 20 November 2026)
- FreeLLMAPI docs: Response headers (đã kiểm tra 20 November 2026)