Créditos e preço

Créditos

Um crédito é um real. Preço, saldo, limites e extrato são em reais. A API conta em milionésimos de real (preco_micros): 14499640 é R$ 14,499640.
Os créditos são da organização e valem para todos os projetos dela.
O saldo e o extrato ficam no app, em Créditos e uso; o extrato baixa em CSV.

Comprar créditos

Admins e donos da organização compram créditos no app, em Créditos e uso:

O valor: pacotes de R$ 20, R$ 50, R$ 100 e R$ 250, ou outro valor a partir de R$ 20,00.
O pagamento: Pix, pelo QR Code ou pelo código copia e cola, ou boleto.
Quando os créditos entram: assim que o pagamento é confirmado. O Pix leva segundos; o boleto, até três dias úteis para compensar. A tela acompanha a cobrança e mostra quando o saldo subiu.
Os dados de cobrança, pedidos na primeira compra: o CNPJ da empresa, a razão social, o endereço completo e o e-mail da nota, que começa igual ao da conta. Criar a conta não pede nenhum deles. A nota fiscal de serviço sai em nome da empresa, e a prefeitura exige o endereço completo. Depois de salvo, o CNPJ aparece mascarado, como **.222.333/****-**; para mudar os dados, digite o CNPJ de novo. Admins e donos mudam esses dados em Créditos e uso.
Quem compra: uma empresa, pelo CNPJ. Sem ele, a conta lê o que é gratuito, como o diagnóstico da cidade, mas não compra créditos.
Validade da cobrança: uma cobrança não paga em 7 dias é cancelada. Basta gerar outra.
Estorno de uma compra: a pedido, pelo suporte@brasilsintetico.com, devolvemos a parte da compra que ainda está livre, menos uma taxa de serviço de R$ 2,00. Os créditos devolvidos e a taxa saem do saldo disponível, cada um numa linha do extrato. Créditos já usados em jobs não voltam. Não há taxa quando o estorno corrige um erro nosso, como uma cobrança em dobro, nem quando a lei garante o direito de arrependimento.

Quanto custa uma simulação

O preço é fixado antes de rodar, pela cotação, e é exatamente o que se cobra se o job concluir.

Tabela de preços

Tarifa	R$
Por milhão de pessoa-dias	0,00172
Por job	3,95
Mínimo por job	5,50

pessoa_dias = população das UFs × dias × variantes × réplicas
preço       = máximo(5,50 ; 3,95 + 0,00172 × pessoa_dias / 1.000.000)

A parte por pessoa-dias é arredondada para cima ao milionésimo de real. Por exemplo, 6.133.511.100 pessoa-dias dão 10,54963909…, arredondado para 10,549640; somada a tarifa por job, o preço é R$ 14,499640.

A tabela é fixa e revista a cada trimestre. Uma mudança entra aqui e em Novidades antes de valer; um job já cotado e enviado paga o preço da cotação.

População das UFs: a população inteira de cada UF do pedido na release, mesmo quando o público-alvo ou a geografia são menores. Todo mundo é simulado; o alvo só diz a quem a mídia chega.
Variantes: 1 sem canais; 2 com um canal; 1 + 2N com N ≥ 2 canais (O cenário).

Exemplos (release `v2.0.0`; nas releases `v1.x`, a população de cada UF difere em menos de 0,01%, e o preço quase não muda)

Pedido	Pessoa-dias	Preço (R$)
Recepção, MG, 30 dias, 1 canal (2 variantes), 1 réplica	1.226.702.220	6,059928
Recepção, MG, 30 dias, 2 canais (5 variantes), 2 réplicas	6.133.511.100	14,499640
Recepção, RR, 30 dias, 1 canal (2 variantes), 1 réplica	37.169.100	5,500000 (o mínimo)

Para saber o preço de qualquer pedido, use POST /v1/jobs/estimate (ou estimate_simulation no MCP). A cotação não reserva nem cobra nada.

Quanto custa uma calibração

Uma calibração paga a mesma tarifa por todas as rodadas que faz: os candidatos da busca, duas por parâmetro livre e a do escolhido até o fim do holdout. POST /v1/calibracoes/estimate dá o preço sem reservar nada.

Quanto custa o diagnóstico de uma cidade

Nada. O diagnóstico por setor é gratuito desde 12 de outubro de 2026: abrir uma cidade num projeto não reserva nem cobra créditos, e a cotação (GET /v1/diagnosticos/{codigo}/cotacao ou quote_city_diagnosis no MCP) mostra os setores e o preço: zero para uma cidade ainda não aberta. Uma cidade aberta antes dessa data guarda no recibo o que pagou, e a cotação dela mostra esse valor.

Quanto custa o chat

O chat é cobrado pelo texto que o assistente lê e escreve, contado em tokens (pedaços de palavra; em português, um token tem em média três a quatro caracteres).

Por milhão de tokens	R$
Lidos	31,56
Escritos	157,80
Lidos de novo, do cache da conversa	3,16
Guardados no cache da conversa	39,45

O custo de uma resposta depende do tamanho da conversa e dos documentos lidos. Um documento longo custa mais na primeira leitura e depois vem do cache.
Antes de cada resposta, o máximo que ela pode custar é reservado, como num job. Depois, é cobrado só o que foi usado, e o resto volta. Sem saldo, ou acima do limite de gasto mensal, a mensagem não é respondida.
No extrato, cada resposta aparece como uma reserva, uma cobrança e a devolução do resto, marcadas chat.

Limite de gasto e alerta de saldo

Em Créditos e uso, um admin pode definir dois controles para a organização:

Limite de gasto mensal: o que foi cobrado no mês (UTC), mais o que está reservado, mais o preço do job novo, não passa do limite. Acima dele, o envio é recusado com 402 spend_limit_reached.
Alerta de saldo baixo: abaixo do valor escolhido, o app avisa todos os membros.

Os dois são opcionais e podem ser desligados.

Quando se cobra

Momento	O que acontece
Envio (`POST /v1/jobs`)	O preço é reservado. Sem saldo, o envio é recusado com `402 insufficient_credits`.
`concluido`	A reserva vira cobrança do preço cotado.
`falhou`	A reserva volta inteira: o reembolso é automático.
`cancelado`	A reserva volta inteira: o reembolso é automático.