anthropic.PermissionDeniedError: Error code: 403 - {'type': 'error', 'error': {'type': 'permission_error', 'message': 'Your API key does not have permission to use the specified resource.'}}
Cheia API e validă (altfel ai primi 401), dar nu are voie să folosească resursa cerută: modelul, funcția sau workspace-ul. Verifică în consolă workspace-ul și permisiunile cheii sau folosește o cheie cu acces; în cod, tratează 403 separat și nu-l reîncerca.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Codul 403 (permission_error) înseamnă: te-am recunoscut, dar nu ai voie. E diferit de 401, unde cheia nu e acceptată deloc. Cererea a ajuns la API, cheia a trecut de autentificare, iar refuzul vine din permisiuni.
Cauzele tipice: cheia aparține unui workspace sau unei organizații care nu are acces la modelul sau funcția cerută; un administrator a restricționat cheia; folosești o funcție în beta pentru care contul nu e activat; sau ai cheia unui coleg, din alt workspace decât resursa (de exemplu un lot creat cu altă cheie).
Un 403 nu trece singur: SDK-ul nu îl reîncearcă și nici tu nu trebuie să-l reîncerci. Notează request_id din eroare, verifică permisiunile în consolă și afișează utilizatorului un mesaj neutru.
De ce apare: cauzele frecvente
1Cheie din alt workspace decât resursa
# cheia echipei de marketing, fără acces la resursa echipei de suport
client = anthropic.Anthropic()
client.messages.batches.retrieve(lot_id)# cheia workspace-ului care a creat lotul
client = anthropic.Anthropic()
client.messages.batches.retrieve(lot_id)Resursele (loturi, fișiere) aparțin workspace-ului în care au fost create. O cheie din alt workspace e validă, dar nu are drept de acces la ele.
2Reîncercări inutile pentru 403
except anthropic.APIStatusError:
time.sleep(5)
return raspunde(intrebare)except anthropic.PermissionDeniedError as e:
log(f"403, request_id={e.request_id}")
return "Asistentul nu este disponibil momentan."Un 403 dă același rezultat la fiecare încercare. Reîncercarea doar ascunde problema; un mesaj în log cu request_id duce direct la cauză.
Repară eroarea, direct în pagină
Cheia folosită de asistent primește 403 permission_error, iar programul cade. Până când administratorul repară permisiunile, aplicația trebuie să rămână în picioare: prinde anthropic.PermissionDeniedError, afișează în log LOG: 403, request_id=<id>: verifică workspace-ul și permisiunile cheii și întoarce clientului Asistentul nu este disponibil momentan. Nu reîncerca cererea.
import anthropic
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic()
def raspunde(intrebare):
r = client.messages.create(model=MODEL, max_tokens=200, messages=[{"role": "user", "content": intrebare}])
return r.content[0].text
print("Client vede:", raspunde("Ce garanție are aspiratorul?"))LOG: 403, request_id=req_sim_0001: verifică workspace-ul și permisiunile cheii Client vede: Asistentul nu este disponibil momentan.
Indiciu
Excepția are atributele status_code și request_id.
Reparația
import anthropic
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic()
def raspunde(intrebare):
try:
r = client.messages.create(model=MODEL, max_tokens=200, messages=[{"role": "user", "content": intrebare}])
return r.content[0].text
except anthropic.PermissionDeniedError as e:
print(f"LOG: {e.status_code}, request_id={e.request_id}: verifică workspace-ul și permisiunile cheii")
return "Asistentul nu este disponibil momentan."
print("Client vede:", raspunde("Ce garanție are aspiratorul?"))De ce merge
403 înseamnă că cheia e recunoscută, dar nu are drept la resursa cerută, așa că orice reîncercare primește același răspuns. Prinzând exact PermissionDeniedError, aplicația nu mai cade, clientul vede un mesaj neutru, iar logul conține codul și request_id, cu care găsești imediat cererea în consolă. Reparația definitivă se face în consolă: cheia din workspace-ul corect sau permisiunile potrivite, nu în cod.
Alte forme ale mesajului
anthropic.PermissionDeniedError: Error code: 403 - permission_error: Your API key does not have permission to use the specified resource.openai.PermissionDeniedError: Error code: 403 - You are not allowed to sample from this model
Cum o eviți pe viitor
- Folosește câte o cheie pe aplicație și pe mediu (dezvoltare, producție), creată în workspace-ul potrivit.
- Tratează separat erorile care nu trec singure (400, 401, 403, 404) de cele temporare (429, 5xx, rețea): primele nu se reîncearcă.
- Loghează
e.status_codeșie.request_idla fiecare eroare; cu ele găsești cererea în consolă sau la suport.
Întrebări frecvente
Care e diferența dintre 401 și 403?
La 401 cheia nu e acceptată deloc (greșită, ștearsă, de la alt furnizor). La 403 cheia e bună, dar nu are drept la resursa cerută. 401 se repară cu altă cheie, 403 cu permisiuni sau cu cheia din workspace-ul corect.
Merită să reîncerc după câteva secunde?
Nu. Permisiunile nu se schimbă între două cereri. SDK-ul reîncearcă automat doar erorile temporare (429, 5xx, rețea), iar 403 nu e printre ele.
Erori înrudite
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.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.NotFoundError: Error code: 404 - {'type': 'error', 'error': {'type': 'not_found_error', 'message': 'model: claude-haiku-5.5'}} API-ul nu cunoaște modelul cerut: numele e scris greșit (puncte în loc de cratime, versiune inexistentă) sau modelul a fost retras. Copiază id-ul exact din documentație sau din `client.models.list()`, de exemplu `claude-haiku-5-5`, și ține-l într-o constantă `MODEL`. Î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.
