FlowModels

Editar, renovar ou bloquear chaves de API

Publicado em 11. novembro 2026

Uma chave de API não é algo que você configura uma única vez. Com o tempo, você altera limites, prorroga a validade ou troca uma chave porque ela foi parar nas mãos erradas. As três ações ficam na lista de chaves em Chaves de API, à direita de cada linha.

Editar uma chave

Clique no ícone de lápis (Editar). Permissão, equipe e tipo de cobrança ficam definidos assim que a chave é criada. Você pode alterar:

  • Nome
  • Limite mensal em euros. Deixar vazio significa: sem limite próprio.
  • Válida até. Deixar vazio significa: a chave não expira. A data precisa estar no futuro.
  • Solicitações por minuto. Com isso você limita apenas essa chave, por exemplo a de um ambiente de testes. O valor máximo é o limite de requisições da sua equipe, informado na caixa de diálogo. Se você deixar o campo vazio, a chave pode usar todo o limite da equipe.

Clique em Salvar. As alterações valem na hora, e você não precisa ajustar sua aplicação. Como o limite de requisições da equipe é definido está em Limite de requisições: como funcionam os níveis.

Renovar uma chave

Renovar é o caminho certo quando você quer trocar uma chave regularmente ou desconfia que ela vazou, mas precisa que sua aplicação continue funcionando sem interrupção.

  1. Na linha, clique no ícone de seta (Renovar).
  2. Na caixa de diálogo Renovar chave?, confirme com Renovar.
  3. Copie o novo valor da janela Chave renovada. Ele também só é exibido uma vez.
  4. Coloque o novo valor na sua aplicação.

O valor anterior ainda é aceito durante um período de transição, por padrão 60 minutos. Depois disso, ele é recusado. Durante esse período, a lista mostra a situação Sendo renovada. Nome, limite e consumo são mantidos na renovação.

Bloquear uma chave

Bloquear é o freio de emergência. Uma chave bloqueada perde a validade imediatamente, e isso não pode ser desfeito.

  1. Na linha, clique no ícone de proibido (Bloquear).
  2. Na caixa de diálogo Bloquear chave?, confirme com Bloquear.

A chave continua na lista com a situação Bloqueada, para que o consumo anterior possa ser consultado. Ela não pode mais ser editada nem renovada. Se precisar de acesso novamente, crie uma chave nova. Quando outra pessoa que não o proprietário bloqueia uma chave, o proprietário recebe um e-mail.

Quando algo não funciona

  • Nenhuma chave utilizável: esse aviso aparece quando todas as chaves da equipe estão bloqueadas ou expiradas. Toda chamada é recusada até você criar uma chave nova ou prorrogar a validade de uma chave expirada.
  • Chave de um agente de IA: chaves com a marcação Agente de IA pertencem a um dos seus agentes de IA. O limite e as requisições por minuto podem ser alterados aqui, enquanto o nome e a data de vencimento seguem o agente. Renovar e bloquear só é possível em Gerenciar na página de agentes de IA.
  • Chave expirada: uma chave expirada não está bloqueada. Abra Editar, informe uma nova data em Válida até ou esvazie o campo, e ela volta a funcionar.

Este artigo foi útil?

Voltar para Primeiros passos e chaves de API