Sua aplicação pode verificar por conta própria se ainda há saldo suficiente e quais limites valem para a chave usada. Para isso, há dois endpoints: GET /credits para o saldo da sua equipe e GET /key para a chave. Nenhum dos dois gera custo ou chama um modelo.
Qual chave funciona?
Os dois endpoints funcionam com chaves de permissão Usar IA e Gerenciar chaves. Para um script de monitoramento, o melhor é usar uma chave de gerenciamento própria. Ela pode ler saldo e consumo, mas não pode chamar modelos.
Consultar o saldo: GET /credits
curl https://api.flowmodels.one/v1/credits \
-H "Authorization: Bearer at_sua_chave"
{
"object": "credit_balance",
"currency": "EUR",
"billing_mode": "prepaid",
"balance_micro_eur": 20000000,
"reserved_micro_eur": 1000000,
"available_micro_eur": 19000000,
"outstanding_micro_eur": 0,
"postpaid_limit_micro_eur": 0,
"spendable_micro_eur": 19000000,
"reserved_oldest_at": "2026-11-05T08:15:00+00:00"
}
Todos os valores estão em micro-euros: 1.000.000 de micro-euros equivalem a 1 €. No exemplo, há portanto 20 € de saldo, 1 € reservado para chamadas em andamento e 19 € disponíveis.
| Campo | Significado |
|---|---|
balance_micro_eur |
seu saldo |
reserved_micro_eur |
separado para chamadas em andamento |
available_micro_eur |
saldo descontadas as reservas |
outstanding_micro_eur |
consumo em aberto, ainda não pago, no pós-pago |
postpaid_limit_micro_eur |
seu limite de crédito, se o pós-pago estiver liberado |
spendable_micro_eur |
quanto você ainda pode gastar no total, incluindo o limite de crédito |
billing_mode |
prepaid ou postpaid |
reserved_oldest_at |
momento da reserva em aberto mais antiga, ou null |
Para a pergunta “Minha aplicação pode continuar funcionando?”, o valor certo é spendable_micro_eur. Se uma reserva ficar presa por muito tempo, ou seja, por muitas horas, é um caso que precisamos esclarecer. Nesse caso, fale com o suporte.
Os mesmos valores aparecem na interface em Faturamento, na área Crédito, com Crédito, Reservado e Disponível.

A recarga só pode ser feita na interface, não pela API, veja Recarregar saldo e ativar a recarga automática. O que significam pré-pago e pós-pago está em Pré-pago ou pós-pago.
Verificar a chave: GET /key
GET /v1/key descreve exatamente a chave com que você faz a consulta:
name,uuid,kindestatuscreated_at,last_used_ateexpires_atlimits.spending.monthly_limit_micro_eur: o limite mensal da chave,nullse não houver limite própriolimits.requests.tierelimits.requests.per_minute: seu nível e as requisições por minuto que valem para essa chave. Se a chave tiver um limite de requisições próprio e menor, é esse valor que aparece aqui.limits.concurrency.max_concurrent_requests: quantas requisições sua equipe pode rodar ao mesmo tempolimits.payload: os limites de tamanho de uma requisição individual
Essa chamada nunca mostra o valor da chave nem outras chaves da sua equipe.
Em vez de consultar: receber notificações
Em vez de consultar o saldo periodicamente, você também pode ser avisado. Configure limites de aviso, veja Configurar o limite de gastos e os alertas, e assine o evento de webhook credit.threshold, veja Configurar webhooks do FlowModels. Assim, o FlowModels avisa seu servidor quando um limite for atingido.
Bom saber
- Essas consultas também contam para o seu limite de requisições por minuto. Uma consulta a cada poucos minutos é mais do que suficiente para monitoramento.
- Um limite mensal de chave não aumenta com uma recarga. Quando ele é atingido, você recebe
429 spend_limit_exceeded, mesmo quespendable_micro_eurainda mostre saldo.