URLs base
A configuração que confunde todo mundo: qual URL cada cliente espera, com e sem o sufixo /v1.
Quase toda falha de integração se deve a um erro na URL base. Esta página é a referência para saber exatamente o que configurar.
A regra
| Cliente | Defina a URL base como | Então ele chama |
|---|---|---|
| SDK da Anthropic (Python / TS) | https://aiprimetech.io | https://aiprimetech.io/v1/messages |
| Claude Code | https://aiprimetech.io | https://aiprimetech.io/v1/messages |
| SDK da 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 Anthropic: sem
/v1. Clientes OpenAI: com /v1. O SDK da Anthropic acrescenta /v1/messages à URL base que você fornecer; o SDK da OpenAI acrescenta apenas /chat/completions. Adicionar /v1 a uma URL base da Anthropic gera solicitações para /v1/v1/messages, que retornam erro 404.Como identificar o erro que você cometeu
| Você vê | Significado |
|---|---|
404 e o caminho contém /v1/v1/ | Você adicionou /v1 a uma URL base no estilo Anthropic. Remova esse trecho. |
404 em /chat/completions sem /v1 | Você omitiu /v1 de uma URL base no estilo OpenAI. Adicione esse trecho. |
404 em /v1/chat/completions de uma ferramenta Anthropic | A ferramenta usa Messages, não Chat Completions. Use a URL base e o endpoint da Anthropic. |
| A conexão funciona, mas todas as chamadas retornam erro 401 | URL correta, cabeçalho de autenticação incorreto para esse formato. Consulte Autenticação. |
Verificação sem nenhum SDK
Esta é a maneira mais rápida de comprovar que a URL e a chave estão corretas antes de culpar seu 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 a URL e a chave estão corretas, e qualquer problema restante está na configuração do seu cliente.