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 · Publicado · Revisado
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.
Continue a leitura
Como exigir privacidade em todas as chaves da organização
A organização pode exigir a barreira de privacidade na RN. Entenda o bloqueio da API nativa, o erro 403 e o caminho protegido para o chat.
Várias chaves de IA com isolamento por organização
Organize conexões de provedores por empresa. Veja como pausa, pesos, consentimento e vínculo de arquivos evitam misturar o uso de clientes.
Como acompanhar custo, limites e recibos de inferência
Diferencie reserva, uso medido e cobrança. Saiba consultar um recibo da RN, interpretar estados pendentes e evitar repetir uma chamada paga.