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
- No dashboard, abra o item Chaves de API.
- No canto superior direito, clique em Criar chave.
- Escolha a Permissão, dê um Nome e, se precisar, defina um Limite mensal e a Validade.
- 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.

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.