Home → Assistenza

404 su /v1/chat/completions quando l'endpoint esiste di sicuro

Cosa vedi

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

Perché succede

Questo inganna più durante il debug che in produzione. Incolli l'URL in un browser, o in uno strumento che usa GET per impostazione predefinita, vedi un 404 e concludi che l'endpoint non funziona. L'endpoint sta bene; semplicemente non ha un gestore per GET.

È facile da verificare: un percorso che davvero non esiste e un percorso che esiste ma rifiuta il tuo metodo restituiscono entrambi 404, ma solo uno cambia comportamento quando passi a POST.

Verifica se la causa è questa

Invia lo stesso percorso due volte, una per ciascun metodo, e confronta:

# 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 seguito da POST 401 significa che l'endpoint è sano e lo stavi testando nel modo sbagliato. Due 404 significano che il percorso è davvero sbagliato.

Come risolvere

1. Usa POSTChat completions, messages ed embeddings sono tutti endpoint POST. Solo gli endpoint di elenco, come /v1/models, rispondono a GET.
2. Conta i segmenti del percorsoIl percorso completo è /v1/chat/completions. Dimenticare /v1, o raddoppiarlo perché lo aggiunge anche il tuo client, porta in entrambi i casi a percorsi che non esistono.
3. Controlla se un proxy riscrive il percorsoI proxy aziendali e i gateway API a volte tolgono o aggiungono un prefisso. Confronta l'URL registrato dal tuo client con quello che il server dice di aver ricevuto.

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.