Quay lại hướng dẫn
Khắc phục sự cố·21 tháng 8, 2026·Đọc 6 phút

OpenAI “Bạn đã vượt quá hạn mức hiện tại” (insufficient_quota) — tại sao chờ không bao giờ khắc phục được

Đây là lỗi 429 mà backoff không thể khắc phục. insufficient_quota nghĩa là tài khoản của bạn không còn credit có thể chi tiêu — request bị từ chối trước khi bất kỳ mô hình nào chạy và sẽ tiếp tục bị từ chối cho đến khi trạng thái thanh toán thay đổi. Dưới đây là cách xác nhận trạng thái thanh toán và xử lý trong vài phút.

Được xem xét lần cuối vào .

Đây là lỗi 429 mà backoff không thể khắc phục. insufficient_quota nghĩa là tài khoản của bạn không còn credit có thể chi tiêu — request bị từ chối trước khi bất kỳ mô hình nào chạy và sẽ tiếp tục bị từ chối cho đến khi trạng thái thanh toán thay đổi. Dưới đây là cách xác nhận trạng thái thanh toán và xử lý trong vài phút.

Lỗi

phản hồi (HTTP 429)
{
  "error": {
    "message": "You exceeded your current quota, please check your plan and billing details. For more information on this error, read the docs: https://platform.openai.com/docs/guides/error-codes/api-errors.",
    "type": "insufficient_quota",
    "param": null,
    "code": "insufficient_quota"
  }
}

Tổng quan nguyên nhân và cách khắc phục

Nguyên nhânCách khắc phục
Số dư credit trả trước là $0API sử dụng hình thức trả trước: mua credit (hoặc bật tự động nạp tiền) trong Settings → Billing. Chỉ lưu thẻ không tạo thêm gì cho đến khi credit được mua.
Credit dùng thử miễn phí đã hết hạn hoặc đã được sử dụngCredit dùng thử sẽ hết hạn (thường sau 3 tháng) ngay cả khi chưa sử dụng. Cách xử lý vẫn như cũ: thêm phương thức thanh toán và mua credit.
Đã chạm giới hạn ngân sách hằng thángNgân sách do bạn tự đặt trong Limits sẽ chặn request trong phần còn lại của tháng khi đạt đến giới hạn. Hãy tăng giới hạn hoặc chờ sang tháng mới.
Key thuộc về project hoặc organization không có ngân sáchCác key sk-proj- chi tiêu từ project của chúng; một project có thể có giới hạn riêng thấp hơn giới hạn của organization. Hãy kiểm tra project của key trong dashboard, không chỉ tổng số của organization.

Xác nhận đó là vấn đề hạn mức, không phải giới hạn tốc độ

Đọc error.type. rate_limit_exceeded tự hết trong vòng một phút và cần backoff; insufficient_quota không tự hết, nên thử lại chỉ tạo thêm nhiễu. Nếu không chắc, hãy thử lại một lần sau 60 giây: vẫn nhận 429 với cùng thông báo nghĩa là vấn đề thanh toán.

Kiểm tra số dư tín dụng mà khóa thực sự sử dụng

Trong platform.openai.com → Settings → Billing, hãy xem số dư tín dụng. Bằng không hoặc âm: mua thêm tín dụng. Sau đó kiểm tra Settings → Limits để xem giới hạn ngân sách hàng tháng, và — đối với các khóa sk-proj- — giới hạn sử dụng riêng của dự án sở hữu khóa. Cả ba yếu tố đều có thể độc lập gây ra lỗi này.

Ngăn lỗi tái diễn, không chỉ xử lý sự cố hiện tại

Bật tự động nạp tiền với ngưỡng hợp lý để một cuối tuần bận rộn không khiến hệ thống production ngừng hoạt động, đồng thời đặt cảnh báo ngân sách (không chỉ giới hạn cứng) để nhận được thông báo khi sắp chạm giới hạn, trước khi các yêu cầu bắt đầu thất bại.

Nếu bạn gọi qua Kunavo

Kunavo cũng sử dụng mô hình trả trước tương tự, vì vậy phép so sánh trung thực nằm ở phạm vi ảnh hưởng của ví, không phải cơ chế: một số dư Kunavo dùng chung cho cả GPT và Claude, tính theo token, và các yêu cầu thất bại không bao giờ bị tính phí. Khi ví riêng của Kunavo cạn tiền, bạn sẽ nhận 402 với mã insufficient_quota (cố ý dùng cùng mã để cơ chế xử lý lỗi của OpenAI SDK có thể tiếp tục hoạt động) — nạp tiền sẽ xóa lỗi ngay lập tức, không có giới hạn hàng tháng cần gỡ bỏ. Bạn đang lập ngân sách cho việc khắc phục? Mức giá GPT hiện tại theo token, cùng danh sách chính thức của OpenAI để đối chiếu, có tại bảng giá GPT API.

Câu hỏi thường gặp

Tôi đã thêm thẻ tín dụng — tại sao vẫn nhận insufficient_quota?

Vì API sử dụng tín dụng trả trước, không sử dụng trực tiếp thẻ. Thêm thẻ chỉ cho phép mua hàng; bạn vẫn phải mua tín dụng hoặc bật tự động nạp tiền. Lỗi sẽ được xóa trong vòng một hoặc hai phút sau khi số dư trở thành dương.

insufficient_quota có bao giờ tự khắc phục không?

Chỉ trong một trường hợp: giới hạn ngân sách hàng tháng, được đặt lại khi tháng mới bắt đầu. Các trường hợp số dư bằng không và bản dùng thử hết hạn sẽ kéo dài cho đến khi bạn mua tín dụng. Dù thế nào, vòng lặp thử lại cũng không giúp ích — yêu cầu bị từ chối trước khi bất kỳ mô hình nào chạy.

Các yêu cầu 429 thất bại có tốn phí không?

Không — OpenAI từ chối chúng trước bước suy luận, và trên Kunavo, các yêu cầu thất bại cũng không bao giờ bị tính phí. Chi phí thực sự là thời gian ngừng hoạt động, đó là lý do tự động nạp tiền kèm cảnh báo ngân sách hiệu quả hơn chỉ dùng giới hạn cứng.

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.