404 na /v1/chat/completions, choć endpoint na pewno istnieje

Najpierw sprawdź metodę HTTP. /v1/chat/completions odpowiada tylko na POST – GET celowo zwraca 404 praktycznie w każdej bramce zgodnej z OpenAI.

Co widzisz

404 page not found
{"error":{"message":"Invalid URL (GET /v1/chat/completions)"}}
NotFoundError: Error code: 404

Dlaczego tak się dzieje

To łapie ludzi bardziej przy debugowaniu niż na produkcji. Wklejasz adres do przeglądarki albo do narzędzia, które domyślnie używa GET, widzisz 404 i uznajesz, że endpoint nie działa. Endpoint jest w porządku; po prostu nie ma obsługi GET.

Łatwo to sprawdzić: ścieżka, która naprawdę nie istnieje, i ścieżka, która istnieje, ale odrzuca twoją metodę, obie zwracają 404 – ale tylko jedna zmienia zachowanie po przełączeniu na POST.

Sprawdź, czy to ta przyczyna

Wyślij tę samą ścieżkę dwa razy, każdą metodą, i porównaj:

# GET — expect 404 even on a healthy endpoint
curl -s -o /dev/null -w 'GET  %{http_code}\n' \
  'YOUR_BASE_URL/chat/completions'

# POST with a deliberately bad key — expect 401
curl -s -o /dev/null -w 'POST %{http_code}\n' -X POST \
  'YOUR_BASE_URL/chat/completions' \
  -H 'Authorization: Bearer invalid' \
  -H 'Content-Type: application/json' -d '{}'

GET 404, a potem POST 401 oznacza, że endpoint jest zdrowy, a ty testowałeś go niewłaściwie. Dwa razy 404 oznacza, że ścieżka naprawdę jest błędna.

Jak to naprawić

Użyj POSTChat completions, messages i embeddings to wszystko endpointy POST. Na GET odpowiadają tylko endpointy listujące, takie jak /v1/models.
Policz segmenty ścieżkiPełna ścieżka to /v1/chat/completions. Brak /v1 albo podwojenie go, bo klient też je dodaje, w obu przypadkach prowadzi do ścieżek, które nie istnieją.
Sprawdź, czy jakiś proxy nie przepisuje ścieżkiFirmowe proxy i bramki API czasem usuwają lub dodają prefiks. Porównaj adres z logów klienta z tym, który według serwera do niego dotarł.

APICLAN zachowuje się tak samo: GET /v1/chat/completions zwraca 404, a POST zwraca błąd w JSON-ie, dopóki nie podasz ważnego klucza. Endpointy i przykłady są w szybkim starcie.

Powiązane

Unexpected token '<' przy wywołaniu API zgodnego z OpenAI 401 invalid API key – gdy klucz wygląda dobrze, a i tak nie działa

Ostatnio sprawdzono 2026-10-01. Napisane na podstawie problemów zdiagnozowanych na działającej bramce zgodnej z OpenAI, a nie zebrane z innych stron.