RESOURCE_EXHAUSTED là lỗi 429 bao quát của Gemini. Nếu lỗi tự hết sau một phút, bạn đã chạm giới hạn tốc độ — backoff sẽ khắc phục. Nếu lỗi kéo dài đến nửa đêm theo giờ Thái Bình Dương, bạn đã dùng hết hạn ngạch hằng ngày của gói miễn phí — không vòng lặp thử lại nào khắc phục được; chỉ thanh toán hoặc một tuyến khác mới có thể.
Lỗi
{
"error": {
"code": 429,
"message": "Resource has been exhausted (e.g. check quota).",
"status": "RESOURCE_EXHAUSTED"
}
}Tổng quan nguyên nhân và cách khắc phục
| Nguyên nhân | Cách khắc phục |
|---|---|
| Giới hạn tốc độ mỗi phút (RPM/TPM) | Backoff với jitter; làm đều các đợt tăng đột biến. Sẽ hết trong khoảng 60 giây. |
| Đã dùng hết hạn ngạch yêu cầu hằng ngày của gói miễn phí | Chờ đến lần đặt lại hằng ngày — bật thanh toán, tăng hạn ngạch hoặc định tuyến qua cổng trả phí. |
| Nhiều worker dùng chung một khóa | Hạn ngạch tính theo dự án, không theo worker — tập trung bộ giới hạn tốc độ hoặc chia nhỏ qua nhiều dự án/khóa. |
Phân loại: giới hạn theo phút hay hạn ngạch theo ngày
Thử lại một lần sau 60 giây. Thành công → giới hạn tốc độ quy mô phút (thêm backoff và tiếp tục). Vẫn 429 → hạn ngạch hằng ngày; kiểm tra Cloud Console → Quotas để xem bộ đếm chính xác nào đang ở mức 100%.
Đối với giới hạn theo phút: backoff tiêu chuẩn
Mẫu giống mọi lỗi 429 — cấp số nhân, có jitter, chỉ thử lại các trạng thái có thể thử lại. Dùng lại đoạn mã từ hướng dẫn Claude 429 của chúng tôi mà không thay đổi; đoạn mã không phụ thuộc nhà cung cấp.
Đối với hạn ngạch hằng ngày: thay đổi bài toán kinh tế
Hạn ngạch gói miễn phí dành cho việc tạo mẫu. Sản phẩm thực tế cần bật thanh toán cho dự án — hoặc dùng cổng thanh toán theo mức sử dụng, nơi giới hạn là ngân sách của bạn chứ không phải bộ đếm hằng ngày. Hãy so sánh phép tính theo từng token trước khi chọn.
Nếu bạn gọi qua Kunavo
Trên Kunavo, Gemini 2.5 Flash/Pro sử dụng cơ chế trả theo mức dùng trong một ví trả trước — không có bộ đếm gói miễn phí hằng ngày để cạn kiệt và các yêu cầu thất bại không bị tính phí. Với các khối lượng công việc liên tục chạm hạn ngạch hằng ngày của AI Studio, giá theo token (thấp hơn đáng kể so với bảng giá của Google) thường rẻ hơn thời gian kỹ thuật dành cho việc chia nhỏ dự án.
Câu hỏi thường gặp
Hạn ngạch gói miễn phí Gemini được đặt lại lúc nào?
Hạn ngạch hằng ngày được đặt lại vào nửa đêm theo giờ Thái Bình Dương. Giới hạn mỗi phút được đặt lại theo cửa sổ 60 giây trượt.
Backoff có khắc phục được RESOURCE_EXHAUSTED không?
Chỉ với loại theo phút. Hạn ngạch hằng ngày đã cạn sẽ trả về 429 cho mọi lần thử lại cho đến khi được đặt lại — hãy phát hiện trường hợp này (429 vẫn tiếp diễn sau khi chờ 60 giây) và ngừng lãng phí lượt thử lại.
Hướng dẫn liên quan
Thông tin chi tiết hơn về ý nghĩa lỗi có trong tài liệu tham chiếu lỗi; bạn chỉ mất một phút để lấy khóa qua đăng ký và hướng dẫn xác thực.