Créditos e cobranças

A API usa os mesmos créditos do app: um único saldo por organização, sem sobrepreço por integrar.

Consultar o saldo

Com o scope credits:read, consulte o saldo vigente da sua organização a qualquer momento:

GET /v1/credits
Authorization: Bearer bxk_…

{ "balance": 1234 }

O que cobra e o que não

Só a geração custa créditos. Todo o resto — ler, enviar catálogo, exportar — é grátis.

Operação	Cobrança
`POST /v1/generations`	Cobra no sucesso, por idioma gerado. Idiomas que falham não cobram.
`POST /v1/batches`	Reserva os créditos ao enviar; ao ingerir o resultado cobra os sucessos e reembolsa o resto.
`POST /v1/batches/{id}/cancel`	Reembolsa a reserva completa do lote.
`GET · PATCH · DELETE …`	Leituras, upserts, edições e exclusões não cobram.
`GET /v1/export/catalog.csv`	O export não cobra: já foi pago ao gerar.

Se o saldo não for suficiente, a geração responde 402 ANTES de gerar — você nunca fica pela metade nem com cobranças parciais inesperadas.

Mesmos preços do app

Gerar pela API custa exatamente o mesmo que pelo app (os lotes assíncronos são mais baratos que a geração síncrona, como no app). O saldo é compartilhado: o que você gastar pela API aparece em Créditos dentro do app, e vice-versa.

O teto de gasto diário de IA também é compartilhado com o app. Ao atingi-lo, a geração responde 429 sem header Retry-After — repetir não resolve; ele se restabelece no dia seguinte (UTC).

Comprar créditos

Os créditos são comprados no app, na seção Créditos (a API não vende créditos). Comprar exige a função de operador ou superior; as chaves de API apenas os consomem.