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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Codul 401 înseamnă „neautentificat”: cererea a ajuns la server, dar serverul nu acceptă cheia din antetul x-api-key. Nu e o problemă de rețea și nici de cod; cererea e corectă, doar identitatea ta nu e validă. De aceea SDK-ul nu reîncearcă automat: a doua încercare ar eșua la fel.
Cauzele frecvente: cheia are un spațiu sau un rând nou copiat odată cu ea, e o cheie OpenAI (sk-proj-...) dată clientului Anthropic, cheia a fost revocată (de exemplu după ce a ajuns pe GitHub), sau variabila de mediu are o valoare veche. Uneori programul citește altă variabilă decât crezi: un fișier .env neîncărcat sau un terminal deschis înainte să setezi variabila.
În traceback, linia cu messages.create e doar locul unde s-a trimis cererea. Problema e la crearea clientului: de unde vine cheia și ce conține.
De ce apare: cauzele frecvente
1Cheia altui furnizor dată clientului Anthropic
client = anthropic.Anthropic(api_key="sk-proj-4f9a...")# export ANTHROPIC_API_KEY="sk-ant-..."
client = anthropic.Anthropic()Cheile OpenAI nu funcționează la Anthropic și invers. Clientul Anthropic citește singur ANTHROPIC_API_KEY dacă nu îi dai nimic în cod.
2Cheie copiată cu spații sau ghilimele în plus
# .env
ANTHROPIC_API_KEY=" sk-ant-api03-... "# .env
ANTHROPIC_API_KEY=sk-ant-api03-...Un spațiu în plus face cheia diferită de cea emisă, deci serverul o respinge. Verifică valoarea fără caractere în jur.
3Cheie revocată după ce a fost publicată
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic(api_key="sk-ant-api03-cheia-urcata-pe-github")import os
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic(api_key=os.environ["ANTHROPIC_API_KEY"])Cheile publicate pe GitHub sunt detectate și dezactivate. Creează o cheie nouă în consolă și ține-o doar în mediu, nu în cod.
Repară eroarea, direct în pagină
Codul de mai jos dă anthropic.AuthenticationError: Error code: 401 ... invalid x-api-key: colegul a lipit în cod cheia de la OpenAI. Repară crearea clientului: scoate cheia din cod și lasă clientul să o citească din variabila de mediu ANTHROPIC_API_KEY (în editor, simulatorul are o cheie demo validă). Programul afișează răspunsul.
import anthropic
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic(api_key="sk-proj-4f9a2c71e0b8")
raspuns = client.messages.create(
model=MODEL,
max_tokens=200,
messages=[{"role": "user", "content": "Cât costă livrarea în Iași?"}],
)
print(raspuns.content[0].text)Livrarea în Iași costă 15 lei și durează o zi lucrătoare.
Indiciu
anthropic.Anthropic() fără argumente citește cheia din ANTHROPIC_API_KEY.
Reparația
import anthropic
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic() # citește ANTHROPIC_API_KEY din mediu
raspuns = client.messages.create(
model=MODEL,
max_tokens=200,
messages=[{"role": "user", "content": "Cât costă livrarea în Iași?"}],
)
print(raspuns.content[0].text)De ce merge
Serverul a primit o cheie care nu e de la Anthropic, așa că a răspuns cu 401 înainte să se uite la cerere. Soluția nu e să cauți „cheia bună” și să o lipești în cod, ci să nu ții cheia în cod deloc: anthropic.Anthropic() o citește din ANTHROPIC_API_KEY.
Astfel cheia nu ajunge în Git, o poți schimba fără să modifici programul și fiecare mediu (calculatorul tău, serverul de producție) are cheia lui.
Alte forme ale mesajului
anthropic.AuthenticationError: Error code: 401 - authentication_error: invalid x-api-key
Cum o eviți pe viitor
- Ține cheia doar în variabila de mediu
ANTHROPIC_API_KEY(sau într-un.envtrecut în.gitignore), niciodată în cod. - La pornirea aplicației, verifică dacă variabila există și oprește-te cu un mesaj clar dacă lipsește.
- În cod, prinde
anthropic.AuthenticationErrorseparat: e o problemă a ta, nu a utilizatorului, deci logheaz-o ca eroare critică. - Folosește chei separate pentru dezvoltare și producție, ca să poți revoca una fără să o oprești pe cealaltă.
Întrebări frecvente
De ce nu reîncearcă SDK-ul la 401?
Pentru că o cheie invalidă rămâne invalidă. SDK-ul reîncearcă doar erorile temporare (429, 5xx, conexiune); la 401 primești excepția imediat.
Cheia mergea ieri. Ce s-a schimbat?
De obicei cheia a fost ștearsă sau dezactivată (de tine, de un coleg sau automat, după ce a apărut într-un repository public), ori rulezi programul într-un terminal în care variabila are altă valoare. Verifică în consola Anthropic dacă cheia mai e activă.
Ce diferență e între 401 și 403?
401 înseamnă că cheia nu e recunoscută. 403 (PermissionDeniedError) înseamnă că cheia e validă, dar nu are voie să acceseze resursa cerută.
Erori înrudite
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. 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. ModuleNotFoundError: No module named 'anthropic' Python nu găsește pachetul `anthropic` (sau `openai`) în mediul în care rulezi programul. Instalează-l cu `pip install anthropic` în același mediu (venv) cu care rulezi scriptul și verifică dacă numele din `import` e scris corect. Î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.
