FlowModels

Quanto custou minha requisição? usage.cost, reserva e custos adicionais

Publicado em 11. novembro 2026

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.

O registro de requisições com modelo, provedor, tokens e custo por requisição

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 em usage.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 /memories com query é 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-Key cuja 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.

Este artigo foi útil?

Voltar para Saldo e cobrança