FlowModels

Criar chaves de API: permissão, limite e validade

Publicado em 11. novembro 2026

Toda aplicação que usa o FlowModels se autentica com uma chave de API. O ideal é criar uma chave própria para cada aplicação e cada ambiente, por exemplo uma para produção e outra para o ambiente de testes. Assim você vê o consumo separadamente e pode bloquear uma chave sem mexer nas outras.

Criar uma chave

  1. No dashboard, abra o item Chaves de API.
  2. No canto superior direito, clique em Criar chave.
  3. Escolha a Permissão, dê um Nome e, se precisar, defina um Limite mensal e a Validade.
  4. Clique em Criar.

A permissão: Usar IA ou Gerenciar chaves

  • Usar IA: sua aplicação pode enviar mensagens a modelos de IA e receber respostas. É a escolha certa em quase todos os casos.
  • Gerenciar chaves: para programas que devem criar, renovar ou bloquear chaves de API por conta própria. Uma chave desse tipo não pode enviar requisições de IA, mas pode consultar saldo e consumo.

A permissão fica definida assim que a chave é criada. Se você precisar da outra, crie uma segunda chave.

Limite mensal

No campo Limite mensal, informe um valor inteiro em euros entre 1 e 100.000. A chave poderá consumir no máximo esse valor no mês calendário em curso. As requisições em andamento já são reservadas antecipadamente e contam para o limite. Quando o limite é atingido, a API recusa novas chamadas com essa chave até o mês virar ou até você aumentar o limite. Se você deixar o campo vazio, a chave não tem limite próprio, valendo apenas seu saldo e o limite de gastos da sua equipe.

Validade

Em Validade, escolha 30 dias, 90 dias, 365 dias ou Sem vencimento. Depois do vencimento, toda chamada com essa chave é recusada. Você pode alterar a data de vencimento a qualquer momento, mesmo que a chave já tenha expirado.

Copiar a chave

Depois da criação, aparece a janela Chave criada com o valor completo. Copie agora, pelo ícone de copiar, e guarde em um lugar seguro, por exemplo na configuração de ambiente da sua aplicação. Assim que você clicar em Entendi, a chave não pode mais ser exibida.

Trate a chave como uma senha. Ela não deve ficar em código que roda no navegador nem em repositórios públicos.

A lista de chaves

Na lista, você vê para cada chave a Situação (Ativa, Expira em breve, Sendo renovada, Expirada ou Bloqueada), o Limite, o Consumo no mês em curso, quando e por quem foi criada (Criada em) e quando foi usada pela última vez (Último uso). Expira em breve aparece quando a data de vencimento cai nos próximos 14 dias.

A lista de chaves de API com situação, limite, consumo e último uso

Bom saber

  • O proprietário e as pessoas que administram a equipe veem todas as chaves da equipe. Os demais veem apenas as chaves que eles mesmos criaram.
  • Quando outra pessoa que não o proprietário cria uma chave, o proprietário recebe um e-mail. Afinal, é ele quem paga o que a chave consome.
  • Editar, renovar e bloquear estão explicados em Editar, renovar ou bloquear chaves de API.
  • As chaves do FlowModels são separadas dos tokens de API das integrações da FlowSuite. Um token da FlowSuite existente não se torna uma chave do FlowModels e não é cobrado do seu saldo de API.

Este artigo foi útil?

Voltar para Primeiros passos e chaves de API