URL base
La configuración que suele confundir a todo el mundo: qué URL espera cada cliente, con y sin el sufijo /v1.
Casi todas las integraciones fallidas se deben a un error en la URL base. Esta página es la referencia para saber exactamente qué configurar.
La regla
| Cliente | Establecer la URL base en | Entonces llama a |
|---|---|---|
| SDK de Anthropic (Python / TS) | https://aiprimetech.io | https://aiprimetech.io/v1/messages |
| Claude Code | https://aiprimetech.io | https://aiprimetech.io/v1/messages |
| SDK de OpenAI (Python / TS) | https://aiprimetech.io/v1 | https://aiprimetech.io/v1/chat/completions |
| LangChain / LiteLLM / Cursor | https://aiprimetech.io/v1 | https://aiprimetech.io/v1/chat/completions |
Clientes de Anthropic: sin
/v1. Clientes de OpenAI: con /v1. El SDK de Anthropic añade /v1/messages a cualquier URL base que le proporciones; el SDK de OpenAI solo añade /chat/completions. Añadir /v1 a una URL base de Anthropic genera solicitudes a /v1/v1/messages, lo que devuelve un error 404.Cómo identificar el error que has cometido
| Ves | Significado |
|---|---|
404 y la ruta contiene /v1/v1/ | Has añadido /v1 a una URL base de estilo Anthropic. Elimínalo. |
404 en /chat/completions sin /v1 | Has omitido /v1 en una URL base de estilo OpenAI. Añádelo. |
404 en /v1/chat/completions desde una herramienta de Anthropic | La herramienta utiliza Messages, no Chat Completions. Usa la URL base y el endpoint de Anthropic. |
| La conexión funciona, pero todas las llamadas devuelven un error 401 | La URL es correcta, pero la cabecera de autenticación no corresponde a ese formato. Consulta Autenticación. |
Verificación sin ningún SDK
Esta es la forma más rápida de comprobar que la URL y la clave son correctas antes de atribuir el problema a tu framework:
"c"># should return JSON with a "data" array of model ids
curl -s -o /dev/null -w "%{http_code}\n" https://aiprimetech.io/v1/models \
-H "Authorization: Bearer $CLAUDEAPIKEY"A 200 significa que tanto la URL como la clave son correctas y que cualquier problema restante está en la configuración de tu cliente.