Home → Assistenza

404 su /responses: anche la Responses API ha bisogno del prefisso di versione

Cosa vedi

• 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

Perché succede

Il prefisso appartiene alla base URL, non al singolo endpoint. Una volta che base_url termina con /v1, l'SDK genera il percorso corretto per ogni endpoint supportato e non ci pensi più.

È con le richieste scritte a mano che si rompe. Qualcuno copia un esempio curl da un blog che riportava l'URL completo, cambia l'host e perde il prefisso durante la modifica.

Poiché il 404 viene restituito al bordo della rete, non lascia traccia nella cronologia delle richieste dell'account. Si suppone allora che l'endpoint non sia supportato affatto, quando in realtà non lo si è mai raggiunto.

Verifica se la causa è questa

Confronta i due percorsi con la stessa chiave: la differenza è inequivocabile:

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'

Un 404 sul primo e un 400 o 200 sul secondo lo confermano. Un 401 sul secondo significa che il percorso è giusto e la chiave sbagliata: è un altro problema.

Come risolvere

1. Imposta il prefisso una sola volta, in base_urlMetti /v1 alla fine della base URL e lascia che l'SDK costruisca il percorso di ogni endpoint. Modificare i singoli URL è il modo in cui il prefisso si perde.
2. Verifica quali endpoint il gateway serve davveroNon tutti i gateway compatibili con OpenAI implementano la Responses API. Se /v1/responses restituisce 404 mentre /v1/chat/completions funziona, il prefisso è corretto e l'endpoint è davvero assente: usa chat/completions.

Articoli correlati

Ultima verifica: 2026-10-01. Scritto a partire da problemi diagnosticati su un gateway compatibile con OpenAI in produzione, non raccolto da altri siti.