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.
- Na linha, clique no ícone de seta (Renovar).
- Na caixa de diálogo Renovar chave?, confirme com Renovar.
- Copie o novo valor da janela Chave renovada. Ele também só é exibido uma vez.
- 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.
- Na linha, clique no ícone de proibido (Bloquear).
- 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.