Pular para o conteúdo principal

Resumo

O AI Gateway oferece acesso a modelos por API e gerenciamento de chaves. O painel reúne visão geral, modelos, chaves, uso, cobrança e documentação. As chamadas utilizam créditos pagos. O saldo total da conta não deve ser confundido com o saldo elegível para o Gateway. Créditos de outras origens não substituem automaticamente créditos pagos.

Para quem é

  • Quem integra modelos de IA a uma aplicação.
  • Quem precisa separar acesso por chave.
  • Quem quer limitar modelos e origens permitidos.
  • Quem precisa inspecionar chamadas recentes e créditos cobrados.

Como abrir

Use Painel › AI Gateway, com ?tab=ai-gateway. As subseções usam entradas como ?tab=ai-gateway:overview. O painel preserva a seção selecionada na navegação interna.
A tela possui controle de acesso para Premium e Business. A disponibilidade do painel não elimina a necessidade de créditos pagos para as chamadas.

Telas e recursos

Captura de tela: AI Gateway

AI Gateway no DoglyTdc

Visão geral

A visão geral apresenta indicadores de acesso e consumo. Confira o saldo de créditos pagos antes de iniciar uma integração. Não use apenas o saldo total como previsão de capacidade.

Modelos

O catálogo mostra modelos disponíveis no Gateway. Use o identificador apresentado na documentação da própria interface. Uma chave pode restringir quais modelos sua integração consegue solicitar.

Chaves

Cada chave possui nome, estado e escopo. A criação permite configurar modelos, origens, teto mensal e requisições por minuto. A credencial completa é exibida apenas uma vez.
1

Defina o uso

Crie uma chave para a integração desejada. Escolha um nome que permita reconhecer sua finalidade.
2

Restrinja o acesso

Selecione modelos e origens permitidos. Configure limites adequados ao uso esperado.
3

Guarde a credencial

Copie a credencial no momento da criação. Armazene-a de forma segura, fora de conteúdo público.
4

Teste e acompanhe

Faça uma chamada com o modelo permitido. Confira estado, latência e cobrança na seção de uso.

Restrições por chave

A lista de modelos limita o escopo daquela chave. A lista de origens controla os domínios autorizados. A interface também permite configurações amplas, como todos os modelos ou qualquer origem. O teto mensal é expresso em créditos. O limite de frequência é expresso em requisições por minuto. Sem limite configurado não significa saldo infinito.

Estado da chave

Uma chave pode ser desativada e reativada. Revogar é uma ação diferente de apenas desativar. As chamadas identificam chaves revogadas e desativadas com erros diferentes.
1

Identifique a chave

Confira nome, prefixo e informações visíveis no painel. Evite alterar outra integração por engano.
2

Escolha a ação

Desative para interromper o uso da chave. Use revogação quando precisar invalidar a credencial.
3

Confira a integração

Verifique se a aplicação passou a usar uma chave válida. Não continue repetindo chamadas com uma chave revogada.

Uso

A tela carrega até 100 registros recentes. Novos registros recebidos também mantêm a lista limitada aos 100 mais recentes. Essa lista não é um arquivo completo de todo o histórico. Os registros incluem modelo, origem, estado, latência e créditos cobrados. Use esses dados para investigar falhas e consumo recente. Não conclua que não houve uso antigo só porque ele não aparece nessa lista.

Cobrança e documentação

A área de cobrança diferencia créditos pagos de outros créditos. A documentação inclui exemplos de integração e códigos de erro. Consulte os exemplos exibidos na interface para o ambiente em uso.

Créditos e limites

  • O Gateway utiliza créditos pagos.
  • O saldo de outros créditos aparece separado.
  • Cada chave pode ter teto mensal de créditos.
  • Cada chave pode ter limite de chamadas por minuto.
  • Restrições de modelos e origens continuam válidas mesmo com saldo.
  • A lista de uso mostra até 100 registros recentes.

Permissões

O painel verifica o acesso ao recurso conforme o plano. As chamadas precisam de uma chave válida, ativa e não revogada. A chave ainda precisa permitir o modelo e a origem solicitados. Não publique a credencial em exemplos ou repositórios abertos.

Erros comuns

Perguntas frequentes

Não. O Gateway utiliza créditos pagos e os distingue dos demais créditos.
A tela informa que ela é exibida apenas uma vez. Guarde-a com segurança na criação.
Não. Ela apresenta até 100 registros recentes.

Relacionado

Créditos e planos

Scripts