openai.RateLimitError: Error code: 429 - You exceeded your current quota, please check your plan and billing details.
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
# am ChatGPT Plus, deci ar trebui să meargă și API-ul
r = client.responses.create(model=MODEL, input="Salut")# 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
except openai.RateLimitError:
time.sleep(30)
return raspunde(mesaj) # reîncearcă la nesfârșitexcept openai.RateLimitError as e:
if "quota" in e.message:
log.critical("Cota OpenAI epuizată")
return "Asistentul nu este disponibil acum."
raiseLa cotă epuizată, nicio pauză nu ajută. Recunoaște cazul după mesaj și ieși imediat.
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: ....
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?"))ALERTĂ: cota OpenAI epuizată Client vede: Asistentul nu este disponibil acum.
Indiciu
Verifică textul din e.message: cota epuizată conține cuvântul quota.
Reparația
from openai import OpenAI
import openai
MODEL = "gpt-6-luna"
client = OpenAI()
def raspunde(mesaj):
try:
r = client.responses.create(model=MODEL, input=mesaj)
return r.output_text
except openai.RateLimitError as e:
if "quota" in e.message:
print("ALERTĂ: cota OpenAI epuizată")
return "Asistentul nu este disponibil acum."
raise
print("Client vede:", raspunde("Care e termenul de retur?"))De ce merge
SDK-ul a reîncercat deja de două ori (429 e considerat temporar), dar cota epuizată nu trece cu pauze. De aceea programul trebuie să recunoască acest caz și să se oprească imediat, cu un mesaj prietenos pentru client și o alertă pentru tine. Un 429 obișnuit (prea multe cereri pe minut) merge mai departe cu raise, ca să fie tratat de logica de retry.
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
usagepe 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
anthropic.BadRequestError: Error code: 400 - Your credit balance is too low to access the Anthropic API. Please go to Plans & Billing to upgrade or purchase credits. Contul Anthropic al cheii nu mai are credit, așa că API-ul refuză orice cerere. Adaugă credit (sau activează reîncărcarea automată) din Plans & Billing în consola Anthropic; în cod, prinde eroarea și arată utilizatorului un mesaj prietenos, fără să reîncerci. anthropic.RateLimitError: Error code: 429 - rate_limit_error: Number of request tokens has exceeded your per-minute rate limit Ai trimis prea multe cereri sau prea mulți tokeni într-un minut pentru limita contului tău. Eroarea e temporară: așteaptă cât spune antetul `retry-after` și reîncearcă. Lasă SDK-ul să reîncerce (`max_retries`, implicit 2) sau scrie un backoff exponențial cu jitter, și rărește cererile. openai.AuthenticationError: Error code: 401 - {'error': {'message': 'Incorrect API key provided: sk-proj-****abcd. You can find your API key at https://platform.openai.com/account/api-keys.', 'type': 'invalid_request_error', 'param': None, 'code': 'invalid_api_key'}} OpenAI a respins cheia API: e scrisă greșit, a fost ștearsă, e o valoare de exemplu („cheia-ta-aici”) sau e cheia altui furnizor. Creează o cheie nouă în platforma OpenAI, pune-o în variabila de mediu `OPENAI_API_KEY` și creează clientul cu `OpenAI()`, fără cheie în cod. Î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.
