Configurar modelos e API keys
Registre um provedor, configure o backend do modelo e gerencie API keys do tráfego do AI-FW.
Use este guia para adicionar um modelo ao inventário e verificar se o gateway acessa o provedor. API keys ficam na configuração do gateway, não no código cliente.
Antes de começar#
- Confirme que o gateway pode se conectar ao endpoint do provedor.
- Obtenha uma API key autorizada e armazene-a no gerenciador de segredos aprovado.
- Decida se usará chave registrada do modelo ou chave enviada pelo cliente.
Adicionar um modelo#
- Abra Model Inventory.
- Selecione Add custom model.
- Informe ID do modelo, provedor, URL backend e protocolo.
- Adicione API key conforme a política de credenciais.
- Salve e habilite o modelo após verificar os dados.
Modos de chave#
O modo model usa a chave registrada do modelo. O modo client encaminha o Bearer key do cliente e só deve ser usado se BYOK estiver autorizado. Confira precedência regra -> modelo -> global em Settings -> Access Control.
Testar#
Envie uma solicitação de teste com API key AI-FW e o ID do modelo. Verifique Activity e logs para confirmar identidade, modelo, backend e decisão.
Proteger credenciais#
- Não salve API keys em repositórios, exemplos compartilhados ou histórico do terminal.
- Faça rotação ou revogue chaves quando responsáveis ou permissões mudarem.
- Use chaves separadas por modelo quando possível.
- Restrinja quem gerencia credenciais e consulta logs.
Relacionado