Source: https://aiprimetech.io/pt/docs/getting-started/base-urls/

[Início](/pt/) / [Documentação](/pt/docs/) / URLs base 

# URLs base 

A configuração que confunde todo mundo: qual URL cada cliente espera, com e sem o sufixo /v1. 

 Copiar página [ Ver como Markdown](/pt/docs/getting-started/base-urls.md) [ Perguntar ao ChatGPT](https://chatgpt.com/?q=Read%20https%3A//aiprimetech.io/docs/getting-started/base-urls.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.) [ Perguntar no Claude](https://claude.ai/new?q=Read%20https%3A//aiprimetech.io/docs/getting-started/base-urls.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.)   

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](/pt/docs/getting-started/authentication/). 

## 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: 

```
Copy"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. 

[AutenticaçãoCabeçalhos e variáveis de ambiente](/pt/docs/getting-started/authentication/)[Solução de problemasDepuração a partir dos sintomas](/pt/docs/guides/troubleshooting/)[Visão geralReferência de endpoints](/pt/docs/api-reference/overview/) 

[AnteriorModelos e grupos de chaves](/pt/docs/getting-started/models/)[PróximoSua primeira solicitação explicada](/pt/docs/getting-started/first-request/)