model_not_found / 404 — Modellbenennung bei Claude, Gemini und Gateways

Modell-IDs sind nicht portabel: api.anthropic.com erwartet datumsbasierte IDs, Gemini eigene Versionszeichenfolgen und jedes Gateway definiert eigene Slugs. Ein 404 bedeutet hier: „Dieser Host hat kein Modell mit genau dieser Zeichenfolge“ — die Lösung besteht immer darin, den Endpoint nach den bereitgestellten Modellen zu fragen.

Der Fehler

response (HTTP 404)

{
  "error": {
    "type": "model_not_found",
    "message": "The model 'claude-sonnet' does not exist or you do not have access to it.",
    "code": "model_not_found"
  }
}

Ursachen und Lösungen im Überblick

Ursache	Lösung
Modell-ID von einem anderen Host	Jede API hat ihren eigenen Namensraum — übernehmen Sie IDs aus der Modellliste des Endpoints selbst, nicht aus Blogbeiträgen.
Veraltete/umbenannte Version	Provider nehmen datumsbasierte Snapshots außer Betrieb; pinnen Sie eine aktuelle ID und abonnieren Sie Hinweise zu auslaufenden Versionen.
Vertippter oder gekürzter Slug	claude-sonnet ist nirgendwo ein Modell; exakte Zeichenfolgen sind entscheidend.
Modell vorhanden, aber für Ihren Schlüssel/Plan deaktiviert	Einige Hosts schränken Modelle nach Plan ein — der Listen-Endpoint zeigt, welche Modelle IHR Schlüssel aufrufen kann.

Modelle beim aufgerufenen Endpoint auflisten

GET /v1/models ist bei jedem OpenAI-kompatiblen Host die maßgebliche Quelle — es gibt genau die IDs zurück, die Ihr Schlüssel verwenden kann:

list-models.sh

curl -s https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  | python3 -c "import json,sys; print('\n'.join(m['id'] for m in json.load(sys.stdin)['data']))"

Modelle zur Laufzeit statt fest codiert auflösen

Kataloge ändern sich (neue Snapshots, ausgemusterte Modelle). Lösen Sie die Modellliste beim Start auf, bevorzugen Sie konfigurierte Slugs mit einem Fallback und alarmieren Sie, wenn ein konfigurierter Slug aus /v1/models verschwindet, statt in der Produktion 404 zu erhalten.

Wenn Sie Kunavo verwenden

Kunavo verwendet stabile, gut lesbare Slugs (claude-sonnet-5, gpt-5-6-terra, claude-fable-5), die unter GET /v1/models mit Metadaten pro Modell aufgeführt werden. Ausgemusterte Slugs leiten auf den Modellseiten per 301 zu ihren Nachfolgern weiter, sodass Links nicht veralten. Der Listen-Endpoint ist maßgeblich — llms.txt teilt dies jedem Agenten mit, der sie liest.

Häufig gestellte Fragen

Warum funktioniert dieselbe Modell-ID bei einer API, führt bei einer anderen aber zu 404?

Weil IDs pro Host einem eigenen Namensraum angehören: Anthropics datumsbasierte IDs, Geminis versionierte Namen und die Slugs jedes Gateways sind unterschiedliche Zeichenfolgen für verwandte Modelle. Übernehmen Sie sie immer aus der Modellliste des Ziel-Endpoints.

Wie kann ich mich gegen die Ausmusterung von Modellen absichern?

Lösen Sie /v1/models beim Start auf, halten Sie die Modell-ID in der Konfiguration statt im Code, definieren Sie eine Fallback-Kette und benachrichtigen Sie sich selbst, wenn eine konfigurierte ID verschwindet — so wird ein Produktions-404 zu einer Konfigurationsänderung.