# Gateway de IA sem trocar o modelo da sua aplicação

Centralize conexões de IA na RN sem converter o corpo de cada provedor. Entenda o endpoint nativo, o pool autorizado e os limites da migração.

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

## Mude o acesso, preserve o contrato

Uma aplicação que já usa um provedor pode depender de parâmetros que não existem em uma API de chat genérica. No gateway nativo da RN, o caminho /v1/providers/{provider}/ recebe o caminho original da API. O modelo continua no formato esperado pelo provedor.

A aplicação autentica com uma chave RN da organização. O segredo externo fica na conexão do servidor. O gateway conserva corpo, parâmetros, resposta e erro HTTP do provedor. Ele não troca um parâmetro recusado por outro nem muda o modelo para conseguir responder.


## Confira três condições antes da mudança

- A conexão precisa pertencer à organização ou a um fornecedor explicitamente autorizado.
- O caminho e o contrato usados pela aplicação precisam estar disponíveis no gateway. Confira arquivos, streaming e respostas assíncronas além do chat.
- O envio nativo exige consentimento e não aplica a barreira de conteúdo. Uma exigência de privacidade da organização ou do pool fornecedor recusa o pedido.

## Migre um fluxo por vez

Cadastre a conexão, confira o contrato financeiro e escolha o domínio de inferência. Atualize o endpoint e a credencial da aplicação. Valide um pedido representativo, os erros esperados e os recursos que o fluxo consulta depois. Um chat que respondeu não prova que um lote ou upload também funciona.

Sem X-RN-Connection-Id, a seleção ocorre no pool autorizado. Esse cabeçalho é um identificador de conexão, não uma credencial de acesso. Recursos anteriores conservam a conexão que os criou. O gateway não repete automaticamente uma chamada já enviada: confira o estado antes de tentar de novo.


## Perguntas frequentes

Preciso mandar a chave do provedor na aplicação?

A aplicação usa a chave RN da organização. O segredo do provedor fica cifrado na conexão do servidor.

O gateway nativo anonimiza os pedidos?

Não. Ele conserva o corpo original. Use o chat protegido para aplicar a barreira; se ela for obrigatória, o caminho nativo recebe 403.


- [Índice da API da RN](https://rota-nacional.ia.br/api/)
- [OpenAPI do gateway](https://rota-nacional.ia.br/openapi.json)

[Consultar os endpoints](https://rota-nacional.ia.br/pt/docs/)

[Gateway de IA sem trocar o modelo da sua aplicação](https://rota-nacional.ia.br/pt/artigos/gateway-nativo-sem-trocar-modelo/)