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

anthropic.AuthenticationError: Error code: 401 - {'type': 'error', 'error': {'type': 'authentication_error', 'message': 'invalid x-api-key'}}

Pe scurt

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

Greșit
PYTHON
client = anthropic.Anthropic(api_key="sk-proj-4f9a...")
Corect
PYTHON
# 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

Greșit
PYTHON
# .env
ANTHROPIC_API_KEY=" sk-ant-api03-...  "
Corect
PYTHON
# .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ă

Greșit
PYTHON
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic(api_key="sk-ant-api03-cheia-urcata-pe-github")
Corect
PYTHON
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ă tu

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.

Codul care dă eroarea
PYTHON
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)
După reparație, programul afișează
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.

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 .env trecut î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.AuthenticationError separat: 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

← 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.