404 na /responses – Responses API też potrzebuje prefiksu wersji

Responses API działa pod tym samym prefiksem wersji co wszystko inne. Jeśli chat/completions działa pod /v1/chat/completions, responses jest pod /v1/responses. Żądanie na /responses trafia do strony WWW, a nie do API.

Co widzisz

404 Not Found on /responses
openai.NotFoundError: Error code: 404
The same key works for chat/completions but not for responses
Nothing appears in the usage log for the failed call

Dlaczego tak się dzieje

Prefiks należy do base URL, a nie do poszczególnych endpointów. Gdy base_url kończy się na /v1, SDK buduje właściwą ścieżkę dla każdego obsługiwanego endpointu i nigdy więcej nie musisz o tym myśleć.

Psuje się to przy ręcznie pisanych żądaniach. Ktoś kopiuje przykład curl z bloga, w którym wpisano pełny URL, zmienia host i przy edycji gubi prefiks.

Ponieważ 404 jest zwracany na brzegu sieci, nie zostawia śladu w historii żądań konta. Ludzie zakładają wtedy, że endpoint w ogóle nie jest obsługiwany, choć tak naprawdę nigdy do niego nie dotarli.

Sprawdź, czy to ta przyczyna

Porównaj obie ścieżki z tym samym kluczem – różnica jest jednoznaczna:

curl -s -o /dev/null -w 'no prefix: %{http_code}\n' -X POST \
  'https://YOUR_DOMAIN/responses' -H 'Authorization: Bearer YOUR_KEY'
curl -s -o /dev/null -w 'with /v1:  %{http_code}\n' -X POST \
  'https://YOUR_DOMAIN/v1/responses' -H 'Authorization: Bearer YOUR_KEY'

404 na pierwszej i 400 lub 200 na drugiej to potwierdzenie. 401 na drugiej oznacza, że ścieżka jest dobra, a klucz zły – to inny problem.

Jak to naprawić

Ustaw prefiks raz, w base_urlDodaj /v1 na końcu base URL i pozwól SDK zbudować ścieżkę każdego endpointu. Edycja pojedynczych URL-i to sposób na zgubienie prefiksu.
Sprawdź, które endpointy bramka naprawdę obsługujeNie każda bramka zgodna z OpenAI implementuje Responses API. Jeśli /v1/responses zwraca 404, a /v1/chat/completions działa, prefiks jest w porządku, a endpointu naprawdę brak – użyj wtedy chat/completions.

APICLAN obsługuje /v1/responses, /v1/chat/completions i /v1/messages pod tym samym base URL i z tym samym kluczem. Które modele odpowiadają na którym endpoincie, pokazuje GET /v1/models.

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.