# Créditos e uso

O que é um crédito, o que consome um e como fazer o saldo durar.

Canonical page: https://beeuni.ai/docs/pt/credits

Créditos são a unidade de uso da plataforma Beeuni. Toda conta tem um saldo de créditos,
e executar tarefas reduz esse saldo. Quanto mais complexa ou demorada a tarefa, mais
créditos ela consome.

As chamadas de modelo são o principal fator. Os créditos são gastos com tokens de entrada (seu prompt
e o contexto ao redor dele) e tokens de saída (o que o agente escreve em resposta),
e a tarifa depende do nível do modelo selecionado para a sessão. O faturamento e
o próprio saldo são vinculados à conta — consulte [Contas e acesso](/docs/pt/accounts#billing).

<a id="two-kinds-of-credit"></a>

## Dois tipos de crédito

Uma conta pode ter os dois tipos ao mesmo tempo, e eles funcionam de maneiras diferentes:

- **Créditos com validade** — US$ 20 iniciais, válidos por 30 dias; depois US$ 2 por período mensal, sem acúmulo. Créditos de assinaturas pagas também expiram ao fim do ciclo de cobrança. Cobrem o funcionamento do computador e os modelos oficiais.
- **Créditos sem validade** — créditos comprados são armazenados separadamente e acumulam. Reembolsos e outras concessões também podem usar esse saldo; a oferta inicial não.

> **Ordem de consumo**
>
> Os créditos com validade são sempre consumidos primeiro. Os créditos sem validade só são usados
> quando o saldo de créditos com validade chega a zero, para que o limite mensal nunca
> consuma silenciosamente créditos adicionais que você pagou.

<a id="getting-more-credits"></a>

## Como obter mais créditos

| Origem | Tipo | Como obter |
|---|---|---|
| Créditos mensais da assinatura | Com validade | Incluídos em um plano pago, renovados automaticamente todo mês. |
| Créditos adicionais | Sem validade | Comprados quando você precisa. Disponíveis para membros premium. |
| Créditos promocionais e de eventos | Sem validade | Créditos bônus de eventos, promoções ou indicações. |
| Reembolsos | Sem validade | Créditos devolvidos após um problema técnico ou uma tarefa com falha. |

<a id="when-paid-credits-arrive"></a>

## Quando os créditos pagos são adicionados

Os créditos dependem de pagamentos liquidados. Um pagamento aceito, mas ainda não
liquidado, não é adicionado ao saldo até que seja liquidado.

- **Créditos adicionais pagos por débito bancário** — pagamentos com cartão são liquidados na hora. Um débito bancário
(por exemplo, ACH) pode levar vários dias úteis; os créditos chegam quando
for liquidado. Um débito com falha não adiciona créditos.
- **Recarga automática** — a mesma regra se aplica. Enquanto uma recarga por débito bancário
estiver em processo de liquidação, a recarga automática não inicia uma segunda cobrança.
- **Adicionar vagas no meio do ciclo** — cada vaga adicionada é cobrada agora, com valor proporcional ao
restante do ciclo de faturamento. Quando a cobrança é paga, o saldo aumenta com a
mesma proporção do limite mensal da vaga.
- **Remover vagas no meio do ciclo** — a quantidade menor de vagas será cobrada a partir da
próxima renovação. A parte não utilizada do ciclo atual não é reembolsada, e os créditos
já concedidos continuam no saldo.
- **Fazer upgrade de plano no meio do ciclo** — a diferença de preço é cobrada agora, e
o upgrade só é aplicado quando esse pagamento é aprovado. O saldo então aumenta
proporcionalmente ao limite mensal do novo plano. Na próxima renovação,
você recebe o limite integral.

<a id="when-auto-top-up-fails"></a>

## Quando a recarga automática falha

A recarga automática cobra a forma de pagamento salva quando o saldo fica abaixo
do limite definido.

- Uma cobrança que falha por um motivo temporário é tentada novamente em um débito posterior:
no mínimo 5 minutos após a primeira falha e 30 minutos após
a segunda.
- Uma recusa definitiva (por exemplo, saldo insuficiente ou cartão vencido) ou a
terceira cobrança seguida com falha desativa a recarga automática para interromper as cobranças.
- Quando isso acontece, todos os responsáveis pela conta recebem um e-mail com o motivo,
e **Settings → Billing** exibe o motivo ao lado do botão. Atualize a
forma de pagamento e reative a recarga automática.
- Quando o saldo chega a $0, os agentes pausam até que a conta receba créditos.
Em um plano pago com a recarga automática desativada, todos os responsáveis recebem um e-mail na primeira
vez que o saldo chega a $0 em cada dia.
Um membro que não pode adicionar créditos pode clicar em **Ask an owner** no
aviso de falta de créditos: todos os responsáveis recebem um e-mail com o saldo e um link
para Billing. Cada membro pode fazer essa solicitação uma vez por dia.

<a id="tracking-your-usage"></a>

## Acompanhar seu uso

Há duas áreas nas configurações, para duas perguntas diferentes:

- **Settings → Billing** — o saldo atual, dividido entre créditos com validade e
sem validade.
- **Settings → Usage** — o consumo por thread e conversa, para encontrar
as sessões que mais custam.

<a id="making-a-balance-last"></a>

## Como fazer o saldo durar

- **Escolha o modelo adequado para o trabalho.** Use um modelo menor para tarefas simples e reserve
o nível mais avançado para o raciocínio que realmente precisa dele. A diferença de tarifa entre
os níveis é muito maior do que a diferença de qualidade das respostas em uma tarefa fácil.
- **Dê instruções claras.** Uma tarefa bem definida reduz as idas e vindas com
o agente, e cada troca consome tokens.
- **Acompanhe a guia Usage.** Encontre as conversas que consomem mais e
ajuste-as primeiro.
- **Continue na mesma thread.** Turnos repetidos em uma thread aproveitam o cache de prompts, o que
reduz significativamente o custo de tokens.

<a id="if-a-number-looks-wrong"></a>

## Se um valor parecer incorreto

Se algum valor aqui não corresponder ao que foi cobrado, envie um e-mail para
[hello@valkorai.com](mailto:hello@valkorai.com) ou fale conosco no
[Discord](https://discord.com/invite/Yr7UjwbYPC). Estamos comprometidos com um faturamento justo e
transparente — se você acredita que há um erro no uso dos seus créditos,
entre em contato com o suporte e investigaremos o caso prontamente.