FlowModels

Criar, renovar e excluir chaves de API pela própria API

Publicado em 11. novembro 2026

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.

A página Chaves de API com chaves “Usar IA” e “Gerenciar chaves”

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.
  • kind aceita inference (corresponde a Usar IA) e management (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, null se não houver limite próprio
  • requests.tier e requests.per_minute: o nível e as requisições por minuto para essa chave
  • concurrency.max_concurrent_requests: quantas requisições podem rodar ao mesmo tempo
  • payload: 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_scope em chamadas de modelo: ela foi criada sem "kind": "inference" e é uma chave de gerenciamento. Crie uma nova com inference e bloqueie a errada.
  • 404 ao renovar ou bloquear: o uuid não pertence à sua conta ou a chave já está bloqueada.
  • Mensagem de erro ao criar: verifique se name foi preenchido, se expires_at está no futuro e se kind é exatamente inference ou management.

Este artigo foi útil?

Voltar para Primeiros passos e chaves de API