Trang chủ / Hướng dẫn / Gemini API vượt hạn mức (429 RESOURCE_EXHAUSTED)

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.
  • quotaMetric cho biết thứ gì đã cạn. generate_content_free_tier_requests đếm yêu cầu ở gói miễn phí.
  • quotaId cho biết khoảng thời gian. PerDay là hạn mức hằng ngày. Một id PerMinute là giới hạn theo phút.
  • limit là hạn mức của bạn cho mô hình đó trong khoảng thời gian đó.
  • Please retry in cho 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:

Từ trang lỗi API Gemini
MãHTTPÝ nghĩaCách sửa
rate_limit_exceeded429Đã chạm giới hạn yêu cầu hoặc token theo phút hoặc theo giâyThử lại với thời gian chờ tăng dần
quota_exceeded429Đã dùng hết hạn mức hằng ngàyChờ đến lúc đặt lại, hoặc yêu cầu tăng hạn mức
too_many_requests429Quá nhiều yêu cầu trong khoảng thời gian ngắnThử lại với thời gian chờ tăng dần
permission_denied403Dự á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.

Giới hạn Gemini và Gemma miễn phí từ danh mục hiện nay
Mô hìnhMiễn phí trênNgữ cảnhGiới hạn miễn phí (ưu đãi tốt nhất)Công cụThị giác
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaCó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 FlashGoogle AI Studio1M10 yêu cầu/phút
20 yêu cầu/ngày
250,000 token/phút
~3M
CóCó
Gemini 3.6 FlashGoogle AI Studio1M10 yêu cầu/phút
20 yêu cầu/ngày
250,000 token/phút
~3M
CóCó
Gemini 3.5 FlashGoogle AI Studio1M10 yêu cầu/phút
20 yêu cầu/ngày
250,000 token/phút
~3M
CóCó
Gemini 3.8 LiveGoogle 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 ThinkingGoogle 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 TTSGoogle AI Studio-Ongoing AI Studio free-tier quota; account limits applyKhôngKhông
Gemini 3.8 Flash-Lite TTSGoogle AI Studio-Ongoing AI Studio free-tier quota; account limits applyKhôngKhông
Gemini Robotics-ER 2 PreviewGoogle AI Studio131K10 yêu cầu/phút
20 yêu cầu/ngày
250,000 token/phút
~3M
KhôngCó
Gemini 3.5 Flash LiteGoogle AI Studio1M15 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ả

  1. Đọ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.
  2. 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.
  3. 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.
  4. Gửi ít token hơn. Prompt lớn nhanh chóng chạm giới hạn token mỗi phút.
  5. Không đặt max_tokens quá 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ự ánKhôngGiớ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 inCó, với giới hạn theo phútCửa sổ phút được làm mới
Đổi sang mô hình khácCó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-Trail liệ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ấpVấn đề đã biếtCách xử lý
Google AI StudioThinking tokens use output capGemini 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.

Dùng tất cả các mô hình này qua một khóa duy nhất. FreeLLMAPI là bộ định tuyến mã nguồn mở, tự lưu trữ. Nó đặt tất cả các gói miễn phí này sau một endpoint duy nhất tương thích OpenAI, và tự chuyển sang nhà cung cấp khác khi một nhà cung cấp bị giới hạn tốc độ. Xem danh mục hoặc bắt đầu.

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

Nguồn

Tất cả hướng dẫn · Xem tất cả mô hình miễn phí