Recargas e faturamento
Tokia opera como pré-pago: recarregue saldo BRL e consuma conforme usar. Sem mensalidade, sem cartão obrigatório, sem cobrança recorrente automática (a não ser que ative Auto Top-Up).
Métodos de recarga
- pix, instantâneo. QR Code gerado em
/dashboard. Saldo cai em até 30s após pagamento. Sem tarifa para o cliente. - Cartão de crédito, via Auto Top-Up (recarga automática quando saldo cai abaixo do limiar). Cadastro em
/dashboard/billing.
Como o saldo é verificado antes de cada chamada
Antes de encaminhar a requisição ao provedor, a Tokia calcula o custo máximo que ela pode ter e compara com o seu saldo. O custo máximo considera os tokens de entrada mais o max_tokens de saída, no preço do modelo escolhido. Se esse valor não couber, a requisição é recusada com 402 antes de gastar qualquer coisa.
Enquanto a requisição está aberta, esse custo máximo fica reservado. Ele não foi cobrado: é uma reserva, liberada assim que a chamada termina, e o que entra na fatura é o custo real, quase sempre menor. A reserva existe para que várias chamadas simultâneas não somem mais do que você tem em conta.
Por isso, com muitas chamadas em paralelo, você pode receber recusa mesmo tendo saldo aparente. Nesse caso o erro vem com o código in_flight_budget_exhausted e a mensagem diz quanto está comprometido e quanto sobra. É o mesmo comportamento que a OpenRouter aplica sobre nós.
- Recusa por saldo, código
request_exceeds_balance: a chamada sozinha já não cabe. Reduza omax_tokens, escolha um modelo mais barato ou recarregue. - Recusa por concorrência, código
in_flight_budget_exhausted: cada chamada cabe, mas a soma das que estão abertas não. Espere as anteriores terminarem ou recarregue. - Declarar
max_tokensajuda. Sem ele assumimos o limite do modelo, que é alto, e a reserva fica maior do que você precisa.
CPF/CNPJ obrigatório na primeira recarga
O processador de pagamentos exige CPF ou CNPJ válido para emitir cobrança e nota fiscal. Tokia coleta on-demand, só pede no momento da primeira recarga. Sign-up via Google permanece 1-clique sem precisar de dados pessoais.
Reembolso
- Saldo já consumido: não reembolsável (cada chamada IA é serviço prestado).
- Saldo não consumido: ressarcível em até 30 dias após primeira recarga, descontada a tarifa do processador de pagamentos (~3%).
- Encerramento de conta: saldo é restituído em 7 dias úteis via pix.
- Cobrança incorreta (debit duplo, charge sem chamada): retornado em 5 dias úteis após análise.
Nota fiscal
Notas fiscais são emitidas pela IT Booster Global (CNPJ 40.949.316/0001-49). Disponíveis no dashboard em /dashboard/billing. Qualquer dúvida, envie email para contato@usetokia.com.