Anthropic API 404 not_found_error: „model: …“ — warum ein vorhandener Modellname trotzdem 404 liefert

Das Verwirrende an diesem 404 ist, dass das Modell normalerweise tatsächlich existiert — in Anthropics Dokumentation, einem Blogbeitrag oder im Code des letzten Quartals. Es existiert nur nicht in der Liste der Modelle, die Ihr API-Key heute ansprechen darf.

Der Fehler

response (HTTP 404)

{
  "type": "error",
  "error": {
    "type": "not_found_error",
    "message": "model: claude-3-5-sonnet"
  }
}

Ursachen und Lösungen im Überblick

Ursache	Lösung
Ein ausgemusterter datierter Snapshot	Snapshots werden nach einem veröffentlichten Zeitplan veraltet und lösen sich anschließend nicht mehr auf. Wechseln Sie zu einem aktuellen Snapshot.
Ein Alias, der nie existiert hat	`claude-3-5-sonnet` ist eine Familie, keine aufrufbare ID. Anthropic-IDs enthalten eine Version oder ein Datumssuffix.
Das Modell existiert, ist aber für Ihr Konto nicht aktiviert	Neueste Modelle können durch die Tarifstufe beschränkt sein. Der 404 ist von einem Tippfehler nicht zu unterscheiden — prüfen Sie den Models-Endpunkt, nicht die Dokumentation.
Ein OpenAI-Modellname an einem Anthropic-Endpunkt	`gpt-4o` bei api.anthropic.com bedeutet ein fehlendes Modell, keinen Routingfehler. Verwenden Sie ein Gateway, wenn Sie einen Endpunkt für beide Anbieter möchten.

Fragen Sie die API, nicht die Dokumentation

Die Dokumentation beschreibt den Katalog; der Models-Endpunkt beschreibt Ihren Katalog. Wenn beide voneinander abweichen, ist der Endpunkt maßgeblich. Alles, was in dieser Liste fehlt, liefert 404, unabhängig davon, wie aktuell es anderswo aussieht.

list-models.sh

curl -s https://api.anthropic.com/v1/models \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  | grep '"id"'

Bewusst pinnen, bewusst aktualisieren

Das Festcodieren eines datierten Snapshots sorgt für Reproduzierbarkeit und einen zukünftigen 404 an einem Datum, das Sie nicht gewählt haben. Wenn Sie die Modell-ID aus der Konfiguration lesen, ist die Behebung ein Wert zur Deployment-Zeit statt einer Codeänderung — und derselbe Schalter ermöglicht den Failover, wenn ein Modell ausgelastet statt nicht vorhanden ist.

model_config.py

import os

# One place to change when a snapshot retires.
MODEL = os.environ.get("LLM_MODEL", "claude-sonnet-5")

resp = client.chat.completions.create(
    model=MODEL,
    messages=[{"role": "user", "content": "ping"}],
)

404 von 400 und 403 unterscheiden

404 bedeutet, dass der Name zu nichts aufgelöst wurde. 400 bedeutet, dass der Name korrekt war, die Anfrage jedoch nicht (falscher Parameter, fehlerhafter Inhalt). 403 bedeutet, dass das Modell existiert, Sie es aber nicht verwenden dürfen. Nur ein 404 wird durch Änderung des Modellnamens behoben.

Wenn Sie Kunavo verwenden

Kunavos Katalog ist die Liste, die sein /v1/models-Endpunkt zurückgibt, und jede darin enthaltene ID kann mit jedem aufgeladenen Key aufgerufen werden — es gibt keine kontobezogene Modellbeschränkung, daher tritt der oben genannte Fall „vorhanden, aber für Sie nicht aktiviert“ nicht auf. Da derselbe Endpunkt Claude- und GPT-Familiennamen bereitstellt, ist eine OpenAI-ID außerdem kein Fehler am falschen Endpunkt; sie wird einfach weitergeleitet. Ausmusterungen finden beim Upstream weiterhin statt; wenn ein Modell entfernt wird, wird seine ID weitergeleitet oder dokumentiert, statt stillschweigend 404 zu liefern. Aktuelle IDs und ihre Preise pro Token finden Sie in der Claude-API-Preisliste.

Häufig gestellte Fragen

Ist ein 404 jemals ein vorübergehender Fehler?

Nein. Anders als bei 429, 500 und 529 kann ein erneuter Versuch mit derselben Modell-ID bei einem 404 nur wieder fehlschlagen. Ändern Sie die ID oder beenden Sie den Versuch.

Woher weiß ich, wann ein Snapshot ausgemustert wird?

Anthropic veröffentlicht Ausmusterungsdaten für datierte Snapshots. Wenn Sie Snapshots anpinnen, gehört dieser Zeitplan in den Kalender; wenn Sie die ID aus der Konfiguration lesen, ist es eine Änderung in einer Zeile.

Warum funktioniert der Key meines Kollegen mit demselben Namen?

Die Modellverfügbarkeit kann je nach Kontotarif variieren. Vergleichen Sie die beiden /v1/models-Antworten — diese Differenz ist die Antwort.