Démarrage rapide Tarifs

Accueil → Aide

404 sur /v1/chat/completions alors que l'endpoint existe bel et bien

Vérifiez d'abord la méthode HTTP. /v1/chat/completions ne répond qu'à POST : un GET renvoie 404 par conception, sur pratiquement toutes les passerelles compatibles OpenAI.

Ce que vous voyez

Pourquoi cela arrive

Cela piège davantage pendant le débogage qu'en production. Vous collez l'URL dans un navigateur, ou dans un outil qui utilise GET par défaut, vous voyez un 404 et concluez que l'endpoint est en panne. L'endpoint va bien ; il n'a simplement pas de gestionnaire GET.

C'est facile à vérifier : un chemin qui n'existe vraiment pas et un chemin qui existe mais refuse votre méthode renvoient tous deux 404, mais un seul change de comportement quand vous passez à POST.

Vérifiez si c'est bien la cause

Envoyez le même chemin deux fois, une fois de chaque façon, et comparez :

# 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 suivi de POST 401 signifie que l'endpoint est sain et que vous le testiez de la mauvaise manière. Deux 404 signifient que le chemin est vraiment faux.

Comment le corriger

  1. Utilisez POSTChat completions, messages et embeddings sont tous des endpoints POST. Seuls les endpoints de liste, comme /v1/models, répondent à GET.
  2. Comptez les segments du cheminLe chemin complet est /v1/chat/completions. Oublier le /v1, ou le doubler parce que votre client l'ajoute aussi, mène dans les deux cas à des chemins qui n'existent pas.
  3. Vérifiez si un proxy réécrit votre cheminLes proxies d'entreprise et les passerelles d'API retirent ou ajoutent parfois un préfixe. Comparez l'URL journalisée par votre client avec celle que le serveur dit avoir reçue.
APICLAN se comporte de la même façon : GET /v1/chat/completions renvoie 404 et POST renvoie une erreur JSON tant que vous ne fournissez pas de clé valide. Endpoints et exemples dans le démarrage rapide.

Voir aussi

Unexpected token '<' lors d'un appel à une API compatible OpenAI401 invalid API key : quand la clé semble correcte mais échoue quand même

Dernière vérification le 2026-10-01. Rédigé à partir de problèmes diagnostiqués sur une passerelle compatible OpenAI en production, pas compilé à partir d'autres sites.