...
Eroare Aplicații AI cu LLM · Instalare, import, chei API și facturare

openai.RateLimitError: Error code: 429 - You exceeded your current quota, please check your plan and billing details.

Pe scurt

Contul OpenAI nu mai are credit sau a atins limita lunară de cheltuieli (`insufficient_quota`), deși eroarea vine ca 429. Adaugă credit sau mărește limita din Billing; în cod, nu o reîncerca la nesfârșit ca pe un rate limit obișnuit, ci arată un mesaj și alertează-te.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Mesajul arată ca un rate limit (RateLimitError, cod 429), dar cauza e alta: insufficient_quota înseamnă că s-au terminat banii din cont sau ai atins plafonul lunar setat în organizație. Un rate limit obișnuit trece în câteva secunde; cota epuizată nu trece până nu adaugi credit.

De aceea capcana e reîncercarea: SDK-ul reîncearcă automat orice 429 (de 2 ori, implicit), iar o buclă de backoff scrisă de tine ar aștepta degeaba minute întregi. Eroarea apare des la conturile noi (fără credit preplătit, API-ul nu funcționează chiar dacă ai abonament ChatGPT, care e separat) și în producție, când consumul trece de limita lunară.

În cod, deosebești cele două cazuri după mesaj: dacă e.message conține quota, oprești reîncercările și tratezi eroarea ca pe una de facturare.

De ce apare: cauzele frecvente

1Abonamentul ChatGPT confundat cu creditul API

Greșit
PYTHON
# am ChatGPT Plus, deci ar trebui să meargă și API-ul
r = client.responses.create(model=MODEL, input="Salut")
Corect
PYTHON
# platform.openai.com -> Billing -> adaugă credit pentru API
r = client.responses.create(model=MODEL, input="Salut")

ChatGPT și API-ul se facturează separat. API-ul are nevoie de credit în contul de platformă.

2Cota epuizată tratată ca un rate limit obișnuit

Greșit
PYTHON
except openai.RateLimitError:
    time.sleep(30)
    return raspunde(mesaj)   # reîncearcă la nesfârșit
Corect
PYTHON
except openai.RateLimitError as e:
    if "quota" in e.message:
        log.critical("Cota OpenAI epuizată")
        return "Asistentul nu este disponibil acum."
    raise

La cotă epuizată, nicio pauză nu ajută. Recunoaște cazul după mesaj și ieși imediat.

Repară tu

Repară eroarea, direct în pagină

Programul de mai jos se oprește cu openai.RateLimitError: Error code: 429 - You exceeded your current quota... (simulatorul răspunde mereu așa: contul nu are credit). Repară funcția raspunde(mesaj): prinde openai.RateLimitError; dacă mesajul conține quota, scrie ALERTĂ: cota OpenAI epuizată și întoarce Asistentul nu este disponibil acum.; altfel aruncă eroarea mai departe. Programul afișează Client vede: ....

Codul care dă eroarea
PYTHON
from openai import OpenAI
import openai

MODEL = "gpt-6-luna"
client = OpenAI()


def raspunde(mesaj):
    r = client.responses.create(model=MODEL, input=mesaj)
    return r.output_text


print("Client vede:", raspunde("Care e termenul de retur?"))
După reparație, programul afișează
ALERTĂ: cota OpenAI epuizată
Client vede: Asistentul nu este disponibil acum.
Indiciu

Verifică textul din e.message: cota epuizată conține cuvântul quota.

Alte forme ale mesajului

  • openai.RateLimitError: Error code: 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': None, 'code': 'insufficient_quota'}}

Cum o eviți pe viitor

  • Setează în Billing o alertă de consum și o limită lunară potrivită, ca să nu fii surprins.
  • În codul de retry, reîncearcă doar 429-urile temporare; pe cele cu quota în mesaj, nu.
  • Monitorizează costul din usage pe fiecare cerere, ca să vezi tendința înainte să atingi limita.

Întrebări frecvente

De ce e 429 dacă nu fac multe cereri?

Pentru că OpenAI raportează și cota epuizată cu 429. Citește mesajul: insufficient_quota / You exceeded your current quota înseamnă bani sau limită lunară, nu viteză.

Cât durează până trece?

Nu trece singură. Funcționează din nou după ce adaugi credit sau mărești limita de cheltuieli, de obicei în câteva minute.

Erori înrudite

← Toate erorile Aplicații AI cu LLM

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Aplicații AI cu LLM de la zero, cu exerciții la fiecare lecție

Curs Aplicații AI cu Claude și OpenAI: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 8 lecții sunt gratuite.