Se você precisa de uma chave própria para cada cliente, ambiente ou deploy, não precisa fazer isso à mão. Com uma chave de permissão Gerenciar chaves, seu programa pode criar, listar, renovar e bloquear chaves do FlowModels por conta própria. Veja aqui como fazer e quais são os limites.
A chave de gerenciamento
Primeiro, no dashboard, em Chaves de API, crie uma chave com a permissão Gerenciar chaves, veja Criar chaves de API: permissão, limite e validade. Essa chave não pode chamar modelos. Mas ela pode gerenciar chaves e consultar saldo, status da chave e consumo.

Uma chave com Usar IA é recusada nos endpoints de gerenciamento com 403 insufficient_key_scope.
Os endpoints
O gerenciamento de chaves não fica em api.flowmodels.one, e sim, ainda, em creativeskyline.de. Todos os caminhos começam com https://creativeskyline.de/api/user/api-keys:
| Tarefa | Chamada |
|---|---|
| listar chaves | GET /api/user/api-keys |
| criar chave | POST /api/user/api-keys |
| renovar chave | PUT /api/user/api-keys/{uuid}/regenerate |
| bloquear chave | DELETE /api/user/api-keys/{uuid} |
Com isso, você gerencia apenas chaves do FlowModels que pertencem à sua conta e à sua equipe. A lista inclui apenas chaves ativas e nunca o valor da chave, e sim nome, uuid, kind, data de criação, último uso e data de vencimento.
Criar uma chave para chamadas de modelo
O importante é o campo kind. Se você o omitir, será criada outra chave de gerenciamento. Para chamadas de modelo, defina explicitamente "kind": "inference":
curl -X POST https://creativeskyline.de/api/user/api-keys \
-H "Authorization: Bearer at_sua_chave_de_gerenciamento" \
-H "Content-Type: application/json" \
-d '{"name": "Portal do cliente Staging", "kind": "inference", "expires_at": "2027-06-30"}'
nameé obrigatório, com no máximo 255 caracteres.expires_até opcional e precisa estar no futuro.kindaceitainference(corresponde a Usar IA) emanagement(corresponde a Gerenciar chaves).
A resposta contém no campo data.token a chave completa, além de uuid, name, kind e expires_at. Salve o valor imediatamente no seu gerenciador de segredos. Na interface do FlowModels, ele não pode ser exibido de novo. A nova chave pertence automaticamente ao FlowModels e é cobrada do saldo da sua equipe.
Renovar e bloquear
PUT …/{uuid}/regenerate gera um novo valor e o retorna em data.token. O valor anterior ainda funciona por um período de transição, para que você possa fazer a troca sem interrupção. Mesmo assim, planeje a troca para logo.
DELETE …/{uuid} bloqueia a chave imediatamente. Toda chamada posterior com ela é recusada, e ela deixa de aparecer na lista desse endpoint.
O que só é possível na interface
Um Limite mensal ou um limite de requisições próprio para uma chave não pode ser definido por esses endpoints. Para isso, abra a chave em Chaves de API e edite, veja Editar, renovar ou bloquear chaves de API. A recarga de saldo também só é possível na interface.
Consultar os limites de uma chave
Com GET https://api.flowmodels.one/v1/key, um programa consulta o que vale para a chave em uso. A resposta informa, entre outros, status, kind, expires_at, last_used_at e, em limits:
spending.monthly_limit_micro_eur: o limite mensal em micro-euros,nullse não houver limite própriorequests.tiererequests.per_minute: o nível e as requisições por minuto para essa chaveconcurrency.max_concurrent_requests: quantas requisições podem rodar ao mesmo tempopayload: os limites de tamanho de uma requisição individual
Um milhão de micro-euros equivale a um euro. Essa chamada nunca mostra o valor da chave nem outras chaves. Mais detalhes em Consultar saldo e limites da chave pela API: GET /credits e GET /key.
Quando algo não funciona
- A chave nova recebe
403 insufficient_key_scopeem chamadas de modelo: ela foi criada sem"kind": "inference"e é uma chave de gerenciamento. Crie uma nova cominferencee bloqueie a errada. 404ao renovar ou bloquear: ouuidnão pertence à sua conta ou a chave já está bloqueada.- Mensagem de erro ao criar: verifique se
namefoi preenchido, seexpires_atestá no futuro e sekindé exatamenteinferenceoumanagement.