Um endpoint é um caminho de URL em um servidor que aceita um tipo específico de requisição e retorna um tipo específico de resposta. Em APIs de IA, o endpoint mais comum é o de chat completions — POST /v1/chat/completions no schema da OpenAI, POST /v1/messages na Anthropic. Mas provedores de IA modernos expõem uma constelação de endpoints além do chat: /v1/embeddings para transformar texto em vetores, /v1/images/generations para criação de imagens, /v1/audio/transcriptions para speech-to-text e /v1/models para listar modelos disponíveis. Cada endpoint espera parâmetros de requisição diferentes e retorna formatos de resposta diferentes.
O desafio prático é que endpoints "compatíveis com OpenAI" são apenas aproximadamente compatíveis. Groq, Together AI e Fireworks todos anunciam compatibilidade com OpenAI, e funcionam bem para requisições básicas de chat completion. Mas aprofunde nos detalhes e você encontrará diferenças: alguns não suportam o parâmetro response_format para saída estruturada, outros lidam com tool/function calling de forma diferente, e formatos de resposta de erro variam amplamente. A Anthropic nem tenta ser compatível com OpenAI — sua API Messages usa uma estrutura totalmente diferente, com content como um array de blocos em vez de uma string simples. Quando você está construindo um sistema que roteia entre múltiplos provedores, essas diferenças são onde a maior parte do tempo de engenharia vai.
Versionamento é outra dimensão importante. Provedores evoluem seus endpoints ao longo do tempo, e breaking changes acontecem. A OpenAI usa versionamento baseado em data dos modelos (como gpt-4-0125-preview), enquanto os caminhos dos endpoints em si permanecem estáveis. A Anthropic inclui um header de versão (anthropic-version: 2023-06-01) que determina o schema de requisição/resposta. O Vertex AI do Google usa prefixos de versão no caminho da URL. Quando um provedor deprecia uma versão de endpoint, você tipicamente recebe alguns meses de aviso, mas se não está acompanhando os changelogs, pode acordar uma manhã com uma integração quebrada.
Base URLs também merecem menção, porque não são tão diretas quanto você esperaria. A API da Anthropic fica em api.anthropic.com, mas a OpenAI oferece api.openai.com para acesso direto e URLs base separadas para implantações do Azure OpenAI Service. Alguns provedores têm endpoints regionais para conformidade com residência de dados — suas requisições para europe-west1-aiplatform.googleapis.com permanecem na UE. Para provedores que roteiam através de plataformas de inferência como a API de Inferência da HuggingFace, a base URL é a plataforma (router.huggingface.co) e o identificador do modelo vai no caminho ou nos headers. Entender essa topologia importa porque latência, soberania de dados e faturamento podem todos depender de qual endpoint você está realmente acessando.