Faturamento

Adicione saldo via Stripe → o saldo fica na sua carteira → o custo de cada chamada à API é deduzido em tempo real. Se o saldo chegar a zero, as chamadas retornam 402 insufficient_quota até você adicionar mais créditos.

O modelo de preços

Para cada chamada, o Kunavo calcula o custo do usuário como o maior entre estes dois valores:

• Custo de catálogo — o preço exibido no cartão do modelo (por 1 milhão de tokens, por imagem, por segundo de vídeo etc.) multiplicado pelas unidades de uso efetivas.
• Custo do provedor — o valor cobrado do Kunavo pelo provedor para aquela chamada específica, denominado em créditos, sendo 1 crédito = $0.005.
• Fator de acréscimo — normalmente 1.5 (acréscimo de 50% sobre o custo do provedor de origem). Para alguns modelos de provedores chineses cujo preço de atacado está mais próximo da tarifa oficial do provedor, o fator é reduzido para 1.2 para que nosso preço fique abaixo da tarifa oficial.

A função max() garante que: (a) você nunca pague menos do que o preço de catálogo anunciado; e (b) não tenhamos prejuízo em uma chamada cujo custo do provedor aumente inesperadamente.

Unidades de cobrança por modalidade

Prompts longos são cobrados pela faixa de contexto longo do fornecedor. No GPT-5.5, GPT-5.6 Sol e Terra e GPT-6 Astra, um prompt com mais de 272K tokens de entrada faz com que toda a solicitação seja cobrada a 2× da tarifa de entrada — inclusive leituras e gravações de cache — e 1.5× da tarifa de saída, conforme a faixa publicada pela OpenAI. Claude não cobra adicional por contexto longo: seu contexto de 1M é cobrado pela tarifa padrão.

Tokens em cache

Os modelos de chat armazenam em cache prefixos estáveis dos prompts. As leituras do cache são cobradas bem abaixo da tarifa normal de entrada — 0.10× tanto no Claude quanto na OpenAI, e 0.025× on Claude Fable 5.1, 0.05× on Claude Opus 5.5. As gravações no cache são cobradas a 1.25× de entrada em todos os modelos Claude, inclusive gravações com TTL de 1 hora (abaixo da tarifa da Anthropic, 2×), e nos modelos GPT-5.6 Sol, Terra e Luna, e GPT-6 Astra; nos demais modelos, são cobradas pela tarifa normal de entrada. Cada categoria tem seu próprio desconto por modelo, então os preços de cache mantêm o mesmo desconto sobre a lista de preços do fornecedor que se aplica à entrada e à saída. O piso de max() acima considera o cache, então o desconto chega até você em vez de ser anulado pelo preço de catálogo.

Consulte o guia de cache de prompts para ver a tabela completa de preços, saber como ativar cache_control e entender como o roteamento por afinidade do Kunavo mantém o cache aquecido.

Precisão

Todos os valores no Kunavo são armazenados em micro_cents:

• 1 USD = 100,000,000 micro_cents
• 1 cent = 1,000,000 micro_cents
• Cobrança mínima representável: 0.0001 cent ($0.000001). Muitas chamadas práticas de chat são cobradas por esse valor mínimo.

O painel arredonda valores pequenos para 6 casas decimais (USD) e, a partir de um centavo, para 2 casas decimais. A contabilidade interna é exata.

Recarga

Adicione saldo à sua carteira em /app/billing pelo Stripe Checkout: cartões (Visa, Mastercard, Amex, JCB, UnionPay) onde quer que a Stripe esteja disponível, além de Apple Pay, Google Pay e Link em todos os lugares, exceto na Índia. Métodos condicionados ao país aparecem conforme o mercado do próprio comprador — nos Estados Unidos, Cash App Pay, Klarna, Afterpay, débito bancário ACH (liquidação em 3–5 dias úteis) e criptomoedas (stablecoins), além de Affirm em recargas de $100 ou mais e Zip em recargas de $100 a $1,500; Alipay e WeChat Pay na China continental; KakaoPay, Naver Pay, PAYCO, Samsung Pay e cartões domésticos coreanos na Coreia do Sul; UPI na Índia; Pix no Brasil; iDEAL nos Países Baixos, Bancontact na Bélgica, EPS na Áustria, MB WAY em Portugal e Satispay na Itália; BLIK na Polônia; débito direto Bacs no Reino Unido; e Pay by Bank para compradores no Reino Unido, na Irlanda e na Finlândia.

Preços por faixa

Recarga automática

Opcional. Salve um cartão uma vez em /app/billing e defina três valores: o saldo abaixo do qual recarregar, o valor adicionado a cada recarga e um limite mensal. A partir daí, a carteira se recarrega automaticamente — em segundos após uma liquidação que faça o saldo ficar abaixo do limite e, se nesse meio-tempo uma solicitação for recusada por falta de saldo, antes de respondê-la — para que um agente sem supervisão não seja interrompido por um 402.

Enquanto uma recarga estiver em andamento, uma solicitação recusada recebe um 402 com Retry-After: 3; todas as outras recusas informam o que fazer em seguida. Você pode desativar o recurso ou alterar os valores a qualquer momento na mesma página.

Prazo dos webhooks

Depois que você conclui o Stripe Checkout, o saldo é atualizado por webhook. Normalmente, o webhook é disparado em até 5–10 segundos após a confirmação do pagamento. Pagamentos com cartão são quase instantâneos; um meio de pagamento cuja confirmação seja apenas assíncrona pode levar dias para ser liquidado. Esses pedidos aparecem como processing até os fundos chegarem, e o webhook de liquidação adiciona o crédito à carteira — você não precisa pagar de novo e nada expira nesse período. Um pedido que nunca é concluído aparece como pending, e nossa tarefa de limpeza altera esse rótulo para expired após 24 horas; esse rótulo é apenas visual e não cancela nada.

O livro-razão de créditos

Toda alteração de saldo é registrada em um livro-razão somente de acréscimo:

balance_after_micro_cents é registrado em cada linha, fornecendo um instantâneo por evento. Consulte o histórico completo em /app/billing.

Logs de uso

Cada chamada à API gera uma linha em usage_logs:

• Modelo, status (sucesso / erro), código de status HTTP
• Tokens de entrada / saída, tokens em cache + de gravação no cache, quantidade de imagens, segundos, caracteres
• upstream_cost_micro_cents — o que a Kunavo pagou ao provedor upstream
• cost_micro_cents — o que você pagou (com o acréscimo aplicado)
• Latência, IP da solicitação, user agent, prefixo da chave de API

Disponível em /app/usage, com filtros e páginas de detalhes por chamada.

Chamadas com falha: elas têm algum custo?

Não. A Kunavo só cobra por status = success. Se o provedor upstream retornar 4xx / 5xx ou se nossa tarefa expirar, a chamada será registrada, mas o custo será $0. Nós absorvemos o custo do provedor upstream, em vez de repassá-lo a você.

Reembolsos

Os reembolsos são avaliados caso a caso pelo endereço support@kunavo.com. Casos comuns em que fazemos reembolsos:

• Uma interrupção do serviço do lado da Kunavo que tenha causado perda de parte do seu orçamento.
• Erros de preço que resultaram em cobranças acima dos valores exibidos no catálogo.
• Recarga duplicada por engano via Stripe.

Por padrão, os reembolsos são concedidos como crédito na sua carteira; também é possível solicitar reembolsos para uma conta bancária via Stripe.

Próximos passos

• Tabela completa de preços com descontos em relação aos preços oficiais
• Códigos de erro (incluindo cota)
• Como pagar pela API Claude sem cartão de crédito