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

anthropic.PermissionDeniedError: Error code: 403 - {'type': 'error', 'error': {'type': 'permission_error', 'message': 'Your API key does not have permission to use the specified resource.'}}

Pe scurt

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

Greșit
PYTHON
# cheia echipei de marketing, fără acces la resursa echipei de suport
client = anthropic.Anthropic()
client.messages.batches.retrieve(lot_id)
Corect
PYTHON
# 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

Greșit
PYTHON
except anthropic.APIStatusError:
    time.sleep(5)
    return raspunde(intrebare)
Corect
PYTHON
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ă tu

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.

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

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 și e.request_id la 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

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