Inicio → Ayuda

404 en /responses: la Responses API también necesita el prefijo de versión

La Responses API vive bajo el mismo prefijo de versión que todo lo demás. Si chat/completions funciona en /v1/chat/completions, responses está en /v1/responses. Una petición a /responses llega a la web, no a la API.

Lo que ves

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

Por qué ocurre

El prefijo pertenece a la base URL, no a cada endpoint. Una vez que base_url termina en /v1, el SDK genera la ruta correcta para cada endpoint que admite y no vuelves a pensar en ello.

Donde se rompe es en las peticiones escritas a mano. Alguien copia un ejemplo de curl de un blog que escribía la URL completa, cambia el host y pierde el prefijo al editar.

Como el 404 se devuelve en el borde, no deja rastro en el historial de peticiones de la cuenta. La gente entonces supone que el endpoint no está admitido, cuando en realidad nunca llegó a él.

Comprueba si es esta la causa

Compara las dos rutas con la misma clave: la diferencia no deja dudas:

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 en la primera y un 400 o 200 en la segunda lo confirma. Un 401 en la segunda significa que la ruta es correcta y la clave no: es otro problema.

Cómo solucionarlo

Fija el prefijo una vez, en base_urlPon /v1 al final de la base URL y deja que el SDK construya la ruta de cada endpoint. Editar URL sueltas es como se pierde el prefijo.
Comprueba qué endpoints sirve realmente la pasarelaNo todas las pasarelas compatibles con OpenAI implementan la Responses API. Si /v1/responses devuelve 404 mientras /v1/chat/completions funciona, el prefijo está bien y el endpoint realmente no existe: usa chat/completions.

APICLAN sirve /v1/responses, /v1/chat/completions y /v1/messages con la misma base URL y la misma clave. Qué modelos responden en qué endpoint lo indica GET /v1/models.

Relacionado

Unexpected token '<' al llamar a una API compatible con OpenAI 401 invalid API key: cuando la clave parece correcta pero sigue fallando

Revisado por última vez el 2026-10-01. Escrito a partir de problemas diagnosticados en una pasarela compatible con OpenAI en producción, no recopilado de otras webs.