...
Eroare Aplicații AI cu LLM · Parametri și mesaje respinse de API

anthropic.NotFoundError: Error code: 404 - {'type': 'error', 'error': {'type': 'not_found_error', 'message': 'model: claude-haiku-5.5'}}

Pe scurt

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

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Codul 404 înseamnă „nu există”. Aici, partea model: claude-haiku-5.5 din mesaj îți spune exact ce nume a primit serverul. Cererea e altfel corectă, cheia e validă; doar resursa cerută, modelul, nu există pentru contul tău.

Id-urile modelelor au un format precis: claude-haiku-5-5 (cu cratime), nu „Claude Haiku 5.5” (numele de afișare) și nici claude-haiku-5.5. Alte cauze: un model vechi retras între timp, un id inventat de un chatbot sau un model OpenAI trimis clientului Anthropic (gpt-6-luna la anthropic.Anthropic()).

La OpenAI, mesajul echivalent este The model gpt-x does not exist or you do not have access to it. Partea „you do not have access” acoperă și cazul în care modelul există, dar contul tău nu are încă acces la el.

De ce apare: cauzele frecvente

1Numele de afișare folosit ca id

Greșit
PYTHON
MODEL = "claude-haiku-5.5"
Corect
PYTHON
MODEL = "claude-haiku-5-5"

Id-ul API folosește cratime. Numele cu punct e doar cel afișat în documentație și pe site.

2Model OpenAI trimis la Claude

Greșit
PYTHON
client = anthropic.Anthropic()
r = client.messages.create(model="gpt-6-luna", max_tokens=300, messages=mesaje)
Corect
PYTHON
client = anthropic.Anthropic()
r = client.messages.create(model="claude-haiku-5-5", max_tokens=300, messages=mesaje)

Fiecare furnizor își servește doar modelele lui. Când folosești ambele API-uri, ține câte o constantă de model pentru fiecare.

3Id luat din memorie sau de la un chatbot

Greșit
PYTHON
MODEL = "claude-5-haiku-latest"
Corect
PYTHON
for m in client.models.list().data:
    print(m.id)
MODEL = "claude-haiku-5-5"

client.models.list() îți dă lista exactă de id-uri disponibile pentru cheia ta.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă anthropic.NotFoundError: Error code: 404 ... model: claude-haiku-5.5. Repară constanta MODEL cu id-ul corect al modelului Claude Haiku 5.5 (îl poți afla și din client.models.list()). Programul afișează răspunsul.

Codul care dă eroarea
PYTHON
import anthropic

MODEL = "claude-haiku-5.5"
client = anthropic.Anthropic()

raspuns = client.messages.create(
    model=MODEL,
    max_tokens=200,
    messages=[{"role": "user", "content": "Ce înseamnă statusul coletului „în tranzit”?"}],
)
print(raspuns.content[0].text)
După reparație, programul afișează
„În tranzit” înseamnă că coletul a plecat din depozit și este pe drum spre orașul tău.
Indiciu

Id-urile modelelor Claude folosesc cratime, nu puncte.

Alte forme ale mesajului

  • anthropic.NotFoundError: Error code: 404 - not_found_error: model: claude-haiku-5.5
  • openai.NotFoundError: Error code: 404 - The model `gpt-6` does not exist or you do not have access to it.

Cum o eviți pe viitor

  • Ține numele modelului într-o singură constantă, MODEL, la începutul programului sau în configurare.
  • Copiază id-ul din documentația oficială sau din client.models.list(), nu din memorie.
  • Urmărește anunțurile de retragere a modelelor și testează noul model înainte de schimbare.

Întrebări frecvente

De ce SDK-ul nu reîncearcă la 404?

Pentru că un model inexistent nu apare după câteva secunde. 404 e o eroare definitivă: trebuie schimbat numele din cod.

Cum văd ce modele am disponibile?

Cu client.models.list(), care întoarce id-urile modelelor la care are acces cheia ta, sau în documentația furnizorului, la pagina de modele.

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.