Start → Hilfe

405 Method Not Allowed beim Aufruf einer KI-API

Was Sie sehen

• 405 Method Not Allowed
• Request failed with status code 405
• openai.APIStatusError: Error code: 405
• The POST works in the provider's playground but not from your code

Warum das passiert

SDKs aus der OpenAI-Linie fügen kein Pfadpräfix für Sie hinzu. Was immer in base_url steht, wird wörtlich verwendet und /chat/completions angehängt. Geben Sie https://example.com an, geht die Anfrage an https://example.com/chat/completions; geben Sie die nackte Domain mit Schrägstrich am Ende an, machen manche Clients daraus https://example.com/ – ein schlichtes POST an die Startseite.

Eine Startseite ist statisch. Sie beantwortet GET und HEAD und lehnt alles andere ab – genau das ist ein 405. Die Anfrage hat nie API-Code erreicht, also taucht nichts in Ihrem Nutzungslog auf – und ein leeres Log ist selbst der Hinweis.

Das ist das Spiegelbild des Anthropic-Falls. Claude Code und das Anthropic SDK hängen /v1/messages selbst an und brauchen deshalb die Base URL OHNE /v1. Wer eine funktionierende Claude-Code-Einstellung in einen OpenAI-Client kopiert, erzeugt diesen Fehler jedes Mal.

Prüfen, ob es daran liegt

Fragen Sie den Server, welche Methoden genau dieser Pfad akzeptiert:

curl -s -o /dev/null -w '%{http_code}\n' -X POST 'YOUR_BASE_URL/chat/completions'
# and compare with the bare domain:
curl -s -D- -o /dev/null -X POST 'https://YOUR_DOMAIN/' | grep -i '^allow\|HTTP/'

Antwortet die nackte Domain mit 405 und einem Header Allow: GET, HEAD, haben Sie es gefunden. Ein korrekter API-Pfad liefert 401, wenn der Schlüssel fehlt – ein Authentifizierungsfehler heißt, Sie sprechen mit der API.

So beheben Sie es

1. Das API-Präfix wieder an die Base URL setzenBei Clients im OpenAI-Stil muss die Base URL auf das API-Präfix enden, normalerweise /v1. Das SDK hängt dahinter /chat/completions an und sonst nichts.
2. Nicht den Wert von Claude Code übernehmenClients aus der Anthropic-Linie nehmen den nackten Host, weil sie /v1/messages intern anhängen. Die beiden Einstellungen sehen austauschbar aus und sind es nicht.
3. Den abschließenden Schrägstrich weglassenEine Base URL mit / am Ende kann einen doppelten Schrägstrich erzeugen, und manche Router schicken den an das Frontend statt an die API – dasselbe 405, derselbe fehlende Logeintrag.

Verwandte Themen

Zuletzt geprüft am 2026-10-01. Geschrieben aus Problemen, die auf einem laufenden OpenAI-kompatiblen Gateway diagnostiziert wurden – nicht von anderen Seiten zusammengetragen.