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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Deși vine cu codul 400 (BadRequestError), eroarea nu înseamnă că cererea ta e greșită. API-ul Claude se plătește în avans, din creditul organizației, iar când creditul se termină orice cerere primește acest mesaj, indiferent de model sau de prompt. Codul tău poate fi perfect corect.
Apare des la început, când ai creat contul și o cheie, dar n-ai adăugat încă bani, sau în producție, când consumul a crescut și creditul s-a terminat peste noapte. Problema nu se rezolvă singură, deci reîncercările nu ajută: SDK-ul nici nu reîncearcă automat erorile 400.
În aplicație, important e ce vede utilizatorul: un traceback sau un text tehnic despre „credit balance” nu îi spune nimic. Prinzi anthropic.BadRequestError, recunoști mesajul, scrii în log o alertă pentru tine și îi arăți clientului un mesaj general.
De ce apare: cauzele frecvente
1Cont nou fără credit adăugat
# cheie creată, dar contul are 0 $ credit
raspuns = client.messages.create(model=MODEL, max_tokens=300, messages=mesaje)# Consola Anthropic -> Plans & Billing -> adaugă credit
raspuns = client.messages.create(model=MODEL, max_tokens=300, messages=mesaje)Cheia singură nu e suficientă: API-ul folosește creditul preplătit al organizației. După ce adaugi credit, același cod funcționează.
2Aplicația cade pentru toți utilizatorii când se termină creditul
def raspunde(mesaj):
r = client.messages.create(model=MODEL, max_tokens=300, messages=[{"role": "user", "content": mesaj}])
return r.content[0].textdef raspunde(mesaj):
try:
r = client.messages.create(model=MODEL, max_tokens=300, messages=[{"role": "user", "content": mesaj}])
return r.content[0].text
except anthropic.BadRequestError as e:
if "credit balance" in e.message:
log.critical("Credit epuizat: %s", e.message)
return "Asistentul nu este disponibil acum."
raiseFără try/except, excepția oprește aplicația. Cu ea, clientul vede un mesaj normal, iar tu primești alerta în log.
Repară eroarea, direct în pagină
Chatbotul de mai jos se oprește cu BadRequestError: ... Your credit balance is too low ... (simulatorul răspunde așa la prima cerere, apoi creditul revine). Repară funcția raspunde(mesaj): prinde anthropic.BadRequestError, iar dacă mesajul erorii conține credit balance, scrie ALERTĂ: credit epuizat și întoarce Asistentul nu este disponibil acum. Revino în câteva minute.. Celelalte erori 400 merg mai departe (raise).
import anthropic
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic()
def raspunde(mesaj):
r = client.messages.create(model=MODEL, max_tokens=200, messages=[{"role": "user", "content": mesaj}])
return r.content[0].text
for intrebare in ["Aveți parcare?", "Acceptați plata cu cardul?"]:
print("Client vede:", raspunde(intrebare))ALERTĂ: credit epuizat Client vede: Asistentul nu este disponibil acum. Revino în câteva minute. Client vede: Da, acceptăm plata cu cardul și prin transfer bancar.
Indiciu
Mesajul tehnic e în e.message; verifică dacă îl conține pe credit balance.
Reparația
import anthropic
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic()
def raspunde(mesaj):
try:
r = client.messages.create(model=MODEL, max_tokens=200, messages=[{"role": "user", "content": mesaj}])
return r.content[0].text
except anthropic.BadRequestError as e:
if "credit balance" in e.message:
print("ALERTĂ: credit epuizat")
return "Asistentul nu este disponibil acum. Revino în câteva minute."
raise
for intrebare in ["Aveți parcare?", "Acceptați plata cu cardul?"]:
print("Client vede:", raspunde(intrebare))De ce merge
Creditul epuizat nu se repară din cod: îl adaugi din consolă. Codul trebuie doar să nu cadă și să nu-i arate clientului mesajul tehnic. BadRequestError acoperă toate erorile 400, deci te uiți în e.message ca să recunoști cazul de facturare; pe celelalte le lași să urce cu raise, ca să nu ascunzi greșeli reale din cerere.
Primul client primește mesajul prietenos, iar tu vezi alerta. Al doilea apel reușește, pentru că între timp contul a fost reîncărcat.
Alte forme ale mesajului
anthropic.BadRequestError: Error code: 400 - {'type': 'error', 'error': {'type': 'invalid_request_error', 'message': 'Your credit balance is too low to access the Anthropic API. Please go to Plans & Billing to upgrade or purchase credits.'}}
Cum o eviți pe viitor
- Activează reîncărcarea automată a creditului sau o alertă de sold scăzut în consola Anthropic.
- Urmărește costul din
usage(tokeni de intrare și ieșire) pentru fiecare cerere, ca să vezi din timp cât consumi pe zi. - Prinde erorile de facturare separat și trimite-ți o notificare: sunt probleme de rezolvat de tine, nu de utilizator.
- Pune limite de cost pe utilizator, ca un singur client să nu consume tot creditul.
Întrebări frecvente
De ce e 400 și nu 402 sau 403?
Așa o raportează API-ul Anthropic: o cerere care nu poate fi procesată din cauza contului. Contează mesajul, nu doar codul: citește e.message ca să o deosebești de o cerere cu adevărat greșită.
Am adăugat credit și tot primesc eroarea. Ce fac?
Verifică dacă cheia folosită aparține aceleiași organizații (sau aceluiași workspace) căreia i-ai adăugat credit. Dacă ai mai multe organizații în consolă, e ușor să încarci contul greșit.
Erori înrudite
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. anthropic.AuthenticationError: Error code: 401 - {'type': 'error', 'error': {'type': 'authentication_error', 'message': 'invalid x-api-key'}} API-ul Claude a respins cheia trimisă: e greșită, expirată, ștearsă sau e o cheie de la alt furnizor. Pune o cheie validă de la Anthropic (începe cu `sk-ant-`) în variabila de mediu `ANTHROPIC_API_KEY` și creează clientul fără `api_key=` în cod. 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. Î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.
