Como Creditos Funcionam

Dois tipos de creditos

O QuickClaw possui dois tipos de creditos que trabalham juntos para garantir que seu agente nunca fique sem recursos inesperadamente. Entender a diferenca entre eles e essencial para gerenciar seus custos.

Creditos de assinatura

Creditos inclusos no plano Starter (R$80/mes) ou Pro (R$150/mes). Esses creditos sao:

• Per-bot: Cada agente recebe sua propria alocacao de creditos
• Renovaveis: Renovam automaticamente a cada ciclo mensal de billing
• Expiraveis: Creditos nao utilizados expiram ao final do ciclo — nao acumulam
• Exclusivos do plano: Disponíveis apenas para bots Starter e Pro

Creditos avulsos (top-up)

Creditos comprados separadamente via Top-up de Creditos. Esses creditos sao:

• Per-account: Ficam vinculados a sua conta, nao a um agente especifico
• Compartilhados: Todos os bots Starter e Pro da conta podem consumir
• Permanentes: Nunca expiram — use quando precisar
• Taxa de 5%: Uma taxa de servico e retida na compra

Prioridade de debito

Quando seu agente faz uma requisicao ao provedor de IA, o sistema debita creditos seguindo uma ordem estrita:

1. Primeiro: Creditos de assinatura do agente (per-bot)
2. Segundo: Creditos avulsos da conta (per-account, compartilhados)

Essa ordem garante que voce sempre use os creditos que expiram primeiro. Os creditos avulsos (que nunca expiram) so sao consumidos quando os da assinatura acabam.

Calculo de custo

O custo de cada requisicao e calculado com base nos tokens processados e no preco do modelo utilizado. A formula geral e:

custo = tokens * preco_por_mtok / 1.000.000 * markup_exchange_rate

Onde:
- tokens: quantidade de tokens processados (input, output, cache_write ou cache_read)
- preco_por_mtok: preco do modelo por milhao de tokens (em USD)
- markup_exchange_rate: taxa de cambio USD→BRL com markup aplicado

Cada tipo de token tem um preco diferente. O QuickClaw detecta automaticamente se tokens vieram do cache (mais baratos) ou sao novos. Veja detalhes em Cache-Aware Pricing.

Renovacao mensal

Os creditos de assinatura renovam automaticamente no inicio de cada ciclo de billing. O ciclo comeca na data em que voce assinou o plano.

• Exemplo: Se voce assinou dia 15 de janeiro, seus creditos renovam todo dia 15 de cada mes
• Saldo anterior: Creditos de assinatura nao utilizados do ciclo anterior sao descartados — nao acumulam
• Creditos avulsos: Nao sao afetados pela renovacao — permanecem intactos

Saldo zerado

Quando ambos os tipos de creditos (assinatura e avulso) chegam a zero:

• O agente para de responder: Requisicoes ao provedor de IA sao bloqueadas pelo API Proxy
• O agente NAO e deletado: Suas configuracoes, skills, memoria e historico permanecem intactos
• O agente NAO e desligado: O container continua rodando, apenas as chamadas de IA sao bloqueadas

Para retomar o funcionamento, voce pode fazer um top-up de creditos ou aguardar a renovacao mensal dos creditos de assinatura.