No FlowModels, você paga cada requisição individualmente, por consumo. O custo de uma requisição aparece diretamente na resposta dela e no registro de requisições. Veja aqui como ler o valor, por que às vezes é reservado mais do que o valor faturado no fim e quais recursos custam além da entrada e da saída.
O custo na resposta
Toda resposta paga contém o bloco usage:
"usage": {
"prompt_tokens": 42,
"completion_tokens": 24,
"total_tokens": 66,
"cost": "0.000090",
"currency": "EUR"
}
cost é o valor em euros que cobramos por essa requisição, como número decimal em forma de texto. Trate esse valor no seu código como texto ou tipo decimal, e não como ponto flutuante, para evitar erros de arredondamento nas somas. Em respostas por streaming, usage fica no último chunk.
Em outros pontos da API, como GET /credits ou GET /usage, os valores aparecem em micro-euros, como número inteiro. Um milhão de micro-euros equivale a um euro.
Custo no registro de requisições
Em Solicitações, você encontra cada requisição com Momento, Chave, Modelo, Status, Tokens e Custo. Em Mostrar detalhes, você vê também Modelo efetivo, Provedor, Duração, Tokens de prompt e Tokens de resposta. Como filtrar o registro está em Verificar requisições individuais no registro de requisições.

Reserva e cobrança
Antes de enviar uma requisição ao provedor, separamos do seu saldo um valor máximo estimado. Essa é a reserva. Depois da resposta, cobramos o consumo real e liberamos o restante na hora. Por isso, às vezes aparece um valor em Reservas em aberto na Visão geral, enquanto há chamadas em andamento.
É cobrado tudo o que foi necessário para a resposta, inclusive o contexto de conversa do Brain, buscas em arquivos de usuário final e os resumos necessários.
Se não houver um preço confiável para uma requisição, não estimamos: recusamos, por exemplo com 503 pricing_unavailable. Um modelo sem preço cadastrado nem chega a aparecer na lista de modelos.
Vídeos e imagens
Vídeos e imagens não são cobrados por tokens. Por isso, o usage deles mostra 0 tokens, além de seconds ou images.
- Vídeos são cobrados por segundo. No início, reservamos a duração total solicitada. O valor só é debitado quando o vídeo pronto está armazenado conosco. Até lá, ele aparece em Reservas em aberto, mesmo que isso leve vários minutos.
- Imagens são cobradas por imagem. Reservamos o preço de uma imagem e o debitamos assim que a imagem está armazenada.
Mais detalhes em Gerar vídeos e Gerar e editar imagens.
O que custa à parte
Além dos tokens de entrada e saída, estes recursos podem estar incluídos em usage.cost:
- Busca na web: cada busca é cobrada à parte, veja Ativar a busca na web, limitar a domínios e ler as fontes.
- Compactação do histórico: com
context_compression: true, uma chamada adicional de modelo resume seu histórico. Essa parcela aparece separada emusage.flowai.compression. - Áudio em uma mensagem: se o modelo não consegue ouvir áudio por conta própria, nós o transcrevemos antes e cobramos isso à parte.
- Funções próprias: uma chamada de função precisa de duas requisições, e as duas são cobradas.
- Busca em memórias:
GET /memoriescomqueryé pago, listar simplesmente não é. - Arquivos de usuário final: no momento, não há taxa mensal pelo armazenamento. O processamento no upload, como embeddings ou análise de imagem, é cobrado como consumo de modelo.
O que não custa nada
- Requisições que recusamos por causa do seu limite de requisições com
429 rate_limit_exceeded - Requisições que falham já na validação, por exemplo com
400 unsupported_for_model, antes de qualquer reserva - Repetições com o mesmo
Idempotency-Keycuja primeira requisição já deu certo, veja Repetir requisições com segurança - Vídeos e imagens que falham ou são recusados, e vídeos que você cancela antes de a geração começar
Quando a conexão cai
Se a conexão cair durante uma requisição, é cobrado o consumo gerado no provedor até aquele momento. Se você enviar de novo, é uma nova requisição, com novo custo.
Bom saber
- A Visão geral às vezes mostra avisos como “chamadas ainda não têm preço completo” ou “estimativas não são faturadas e não entram nos gastos”. As chamadas afetadas ainda não entram nos Gastos de roteamento do mês.
- As somas por dia, modelo, chave ou usuário final estão em Consumo, veja Analisar o consumo e exportar em CSV.