Inicio rápido Precios

Inicio → Ayuda

404 en /v1/chat/completions cuando el endpoint claramente existe

Revisa primero el método HTTP. /v1/chat/completions solo responde a POST: un GET devuelve 404 por diseño, en prácticamente todas las pasarelas compatibles con OpenAI.

Lo que ves

Por qué ocurre

Esto pilla a la gente más durante la depuración que en producción. Pegas la URL en un navegador, o en una herramienta que usa GET por defecto, ves un 404 y concluyes que el endpoint está caído. El endpoint está bien; simplemente no tiene gestor para GET.

Es fácil de verificar: una ruta que realmente no existe y una ruta que existe pero rechaza tu método devuelven ambas 404, pero solo una cambia de comportamiento cuando cambias a POST.

Comprueba si es esta la causa

Envía la misma ruta dos veces, una de cada forma, y compara:

# 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 seguido de POST 401 significa que el endpoint está sano y lo estabas probando mal. Dos 404 significan que la ruta realmente es incorrecta.

Cómo solucionarlo

  1. Usa POSTChat completions, messages y embeddings son todos endpoints POST. Solo los endpoints de listado, como /v1/models, responden a GET.
  2. Cuenta los segmentos de la rutaLa ruta completa es /v1/chat/completions. Olvidar el /v1, o duplicarlo porque tu cliente también lo añade, lleva en ambos casos a rutas que no existen.
  3. Comprueba si un proxy reescribe tu rutaLos proxies corporativos y las pasarelas de API a veces quitan o añaden un prefijo. Compara la URL que registra tu cliente con la que el servidor dice haber recibido.
APICLAN se comporta igual: GET /v1/chat/completions devuelve 404 y POST devuelve un error en JSON hasta que aportes una clave válida. Endpoints y ejemplos en el inicio rápido.

Relacionado

Unexpected token '<' al llamar a una API compatible con OpenAI401 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.