# Como conectar clientes OpenAI e Anthropic à RN

Escolha entre o catálogo protegido e o gateway nativo antes de configurar um cliente de IA ou agente de código. Modelo, endpoint e chave precisam combinar.

Rota Nacional · 2026-10-30T13:49:50Z · 2026-10-30T13:49:50Z

## Escolha primeiro o contrato

A RN oferece chat compatível com o formato OpenAI em /v1/chat/completions e com o formato Messages em /v1/messages. Esse catálogo usa identificadores rota/* e aplica a política de dados pessoais da organização.

O gateway nativo é outro contrato. Ele conserva o modelo e o formato do provedor por /v1/providers/{provider}/. Não troque um caminho pelo outro apenas mudando o hostname: confira se o cliente precisa de ferramentas, arquivos, multimodalidade ou respostas que aquele caminho suporta.


## Configure endereço, credencial e modelo juntos

Num cliente OpenAI compatível, o endereço base do catálogo é a origem da RN seguida de /v1. Use uma chave RN e um modelo publicado em /v1/models. No cliente Anthropic compatível, a origem e o caminho Messages seguem o exemplo da documentação.

A página de agentes de código reúne os exemplos da RN para clientes suportados. Copie o exemplo do cliente real. Não exponha o segredo em repositório, captura, comando público ou configuração enviada a outra pessoa. O identificador de uma conexão não substitui a chave RN.


## Valide também as falhas

Faça uma chamada curta com conteúdo fictício. Depois confira streaming, ferramentas e limites que seu fluxo realmente usa. Uma resposta 401 indica problema de credencial; 403 pode vir de política da organização; 402 pede saldo ou condição financeira válida. O corpo do erro informa o código específico.

Se a organização exige a barreira, o cliente precisa usar um caminho protegido. Um agente de código não ganha permissão para enviar conteúdo bruto só por conseguir selecionar outro provedor. A aplicação mantém o controle sobre quais arquivos e informações entram no contexto.


## Perguntas frequentes

Posso usar qualquer nome de modelo no catálogo protegido?

Use os identificadores publicados em /v1/models e liberados para a organização. Os nomes nativos dos provedores pertencem ao contrato do gateway nativo.

Compatibilidade de chat garante suporte a toda API do provedor?

Não. Confira os caminhos e os recursos que a aplicação usa. Arquivos, mídia, ferramentas e operações assíncronas têm contratos próprios.


- [Configuração de agentes](https://rota-nacional.ia.br/pt/docs/agentes/)
- [Catálogo público de modelos](https://rota-nacional.ia.br/v1/models)

[Configurar meu cliente](https://rota-nacional.ia.br/pt/docs/agentes/)

[Como conectar clientes OpenAI e Anthropic à RN](https://rota-nacional.ia.br/pt/artigos/integrar-api-openai-anthropic/)