Usar API

Última atualização em 17 de março de 2026

Oferecemos três tipos de API para trabalhar com agentes e modelos de IA:

API compatível com OpenAI: adequada para integração com bibliotecas e interfaces externas, utilizando a estrutura padrão de requisição.
API nativa: mais simples e fácil de usar, especialmente quando é necessário obter um resultado rapidamente sem dependências externas.
AI Gateway: uma API para trabalhar diretamente com modelos sem usar agentes de IA.

Principais diferenças

Recurso	API compatível com OpenAI	API nativa	AI Gateway
Alvo	Um agente	Um agente	Um modelo
Formato da requisição	`messages[]`	`message` + `parentMessageId`	`messages[]`, `responses`
Histórico de mensagens	Enviado na requisição	Armazenado	Enviado na requisição
RAG / MCP	Suportado	Suportado	Não suportado
Configurações do modelo	Pelo painel do agente	Pelos parâmetros da requisição	Enviadas a cada requisição
Seleção de modelo	Limitada ao modelo do agente	Limitada ao modelo do agente	Qualquer modelo disponível
Respostas em streaming	Suportado	Não suportado	Suportado

Qual API escolher

Use a API compatível com OpenAI se você:

quiser integrar o agente com bibliotecas externas (por exemplo, LangChain, Open WebUI)
já utiliza OpenAI e deseja apenas substituir a URL
precisar de estatísticas de uso (tokens, modelo)
precisar de respostas em streaming
planejar usar mensagens multimodais

Use a API nativa se você:

precisar de histórico de mensagens integrado sem enviar contexto explicitamente
estiver desenvolvendo uma aplicação simples com poucas dependências externas
quiser respostas em um formato simples
precisar de uma integração rápida e leve, por exemplo, para um MVP

Use o AI Gateway se você:

precisa trabalhar diretamente com modelos sem lógica de agente
está construindo sua própria lógica (por exemplo, RAG ou roteamento de requisições)
precisa de acesso a vários modelos por meio de uma única API
usa o OpenAI SDK e quer alternar entre modelos sem alterar o código