O que é Endpoint? Significado e exemplos

O que é Endpoint?

Endpoint (endpoint, endpoint de API, URL de API, rota de API, ponto de acesso): Endereço (URL) específico de uma API onde uma operação pode ser realizada. Cada endpoint corresponde a uma função ou recurso, como /chat/completions ou /embeddings, e aceita requisições HTTP com parâmetros definidos.

Atualizado em 10/11/2026 · Por Marcelo Santiago

Como funciona

Um endpoint é a combinação de uma URL e um método HTTP (GET, POST, PUT, DELETE) que define uma operação em uma API. É o "endereço" para onde você envia a requisição.

Em APIs de IA, os endpoints mais comuns são: /chat/completions (gerar texto), /embeddings (gerar embeddings), /images/generations (gerar imagens) e /audio/transcriptions (transcrever áudio). Cada um aceita parâmetros específicos e retorna um formato de resposta definido.

O endpoint inclui a URL base (ex.: https://api.openai.com/v1) mais o caminho do recurso (ex.: /chat/completions). A URL completa é https://api.openai.com/v1/chat/completions.

Exemplo prático

Para chamar a API da OpenAI e gerar texto, você faz um POST para o endpoint https://api.openai.com/v1/chat/completions com um body JSON contendo o modelo, as mensagens e os parâmetros. A resposta vem no mesmo endpoint, com o texto gerado.

Se você usar um SDK, o endpoint é chamado internamente. Se você usar HTTP direto, precisa montar a URL e os headers manualmente. Em ambos os casos, o endpoint é o mesmo.

Para que serve

Serve como ponto de acesso a uma funcionalidade específica de uma API. Permite que desenvolvedores integrem serviços de IA ao seu código de forma previsível e documentada.

Diferença entre endpoint e API

A API é o conjunto completo de endpoints, regras e autenticação de um serviço. O endpoint é um ponto específico dentro dessa API. A API é o "restaurante"; o endpoint é a "mesa onde você pede".

Extensão para VS Code

Gostou da definição de Endpoint? Aplique na prática com IA

Orquestre squads de agentes (Claude, OpenCode, Codex, Antigravity e muito mais) no VS Code com total controle, git worktrees isoladas e suas próprias APIs ou assinaturas sem custos intermediários.

Multi-agentes paralelosAPIs ou assinaturasAgentes para multitarefas

Conhecer o bridgecode

Perguntas frequentes sobre Endpoint

Endpoint e URL são a mesma coisa?

Quase. URL é o endereço genérico. Endpoint é uma URL específica que executa uma operação (com método HTTP definido). Toda endpoint é uma URL, mas nem toda URL é um endpoint de API.

Posso chamar um endpoint diretamente?

Sim, via HTTP (curl, fetch, requests). SDKs são apenas wrappers que chamam os endpoints internamente. Chamar diretamente dá mais controle, mas exige mais código.

O que é um endpoint de streaming?

Um endpoint que retorna a resposta em partes (chunks) à medida que é gerada, em vez de esperar a resposta completa. Reduz a latência percebida e melhora a experiência do usuário.