Accueil → Aide

404 sur /responses : la Responses API a aussi besoin du préfixe de version

La Responses API se trouve sous le même préfixe de version que tout le reste. Si chat/completions fonctionne sur /v1/chat/completions, responses est sur /v1/responses. Une requête vers /responses atteint le site web, pas l'API.

Ce que vous voyez

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

Pourquoi cela arrive

Le préfixe appartient à la base URL, pas à chaque endpoint. Une fois que base_url se termine par /v1, le SDK produit le bon chemin pour chaque endpoint qu'il prend en charge et vous n'y pensez plus.

C'est avec les requêtes écrites à la main que cela casse. Quelqu'un copie un exemple curl d'un blog qui écrivait l'URL complète, change l'hôte et perd le préfixe au passage.

Comme le 404 est renvoyé en périphérie, il ne laisse aucune trace dans l'historique des requêtes du compte. On suppose alors que l'endpoint n'est pas pris en charge du tout, alors qu'on ne l'a en fait jamais atteint.

Vérifiez si c'est bien la cause

Comparez les deux chemins avec la même clé : la différence est sans ambiguïté :

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 sur le premier et un 400 ou 200 sur le second le confirment. Un 401 sur le second signifie que le chemin est bon et la clé mauvaise : c'est un autre problème.

Comment le corriger

Définissez le préfixe une seule fois, dans base_urlMettez /v1 à la fin de la base URL et laissez le SDK construire le chemin de chaque endpoint. Modifier des URL une à une, c'est ainsi qu'on perd le préfixe.
Vérifiez quels endpoints la passerelle sert réellementToutes les passerelles compatibles OpenAI n'implémentent pas la Responses API. Si /v1/responses renvoie 404 alors que /v1/chat/completions fonctionne, le préfixe est bon et l'endpoint est vraiment absent : utilisez chat/completions.

APICLAN sert /v1/responses, /v1/chat/completions et /v1/messages sur la même base URL et avec la même clé. Les modèles disponibles sur chaque endpoint sont indiqués par GET /v1/models.

Voir aussi

Unexpected token '<' lors d'un appel à une API compatible OpenAI 401 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.