> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vetox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Uso de IA

> Saldo de tokens, gasto ao longo do tempo, histórico de solicitações e recargas.

<Info>
  **Apenas tier Black.** Um único orçamento compartilhado cobre [AI Auto-Moderation](/pt/moderation/ai-auto-mod) e [AI Server Control](/pt/moderation/ai-server-control) — não existe cota separada por recurso.
</Info>

## Dois pools

Seu saldo é a soma de dois pools, gastos nesta ordem:

<CardGroup cols={2}>
  <Card title="Monthly grant" icon="calendar">
    **10.000.000 tokens**, recarregados em ciclo de 30 dias. Tokens não usados **não** acumulam.
  </Card>

  <Card title="Top-up" icon="plus">
    Tokens que você comprou. **Nunca expiram** e sobrevivem a renovações e mudanças de plano.
  </Card>
</CardGroup>

A grant é sempre consumida primeiro, então uma top-up funciona como uma reserva de verdade, não algo que se esvai silenciosamente todo mês.

<Warning>
  **O número "Resets in" segue sua data de cobrança, não o ciclo da grant.** Em uma assinatura Black anual, ele pode marcar várias centenas de dias enquanto a grant está sendo recarregada a cada 30 dias.

  Observe o próprio número **Monthly grant** — quando ele volta para 10.000.000, o ciclo rolou.
</Warning>

## Visão geral

| Tile                       | O que conta                                        |
| -------------------------- | -------------------------------------------------- |
| **Token Balance**          | Grant mais top-up — o que você pode gastar de fato |
| **Tokens Used Today**      | Hoje até agora, em UTC                             |
| **Tokens Used This Month** | Mês corrente até a data                            |
| **Requests Today**         | Número de chamadas de IA, não de tokens            |
| **Input / output tokens**  | Detalhados para hoje e para o mês                  |

<Note>
  Os dias viram à **meia-noite UTC**, não no fuso do seu servidor.
</Note>

<Note>
  Os valores mensais ficam em cache por até cinco minutos. Logo após atividade intensa, os tiles diários atualizam antes dos mensais — eles não estão discordando, só atualizando em ritmos diferentes.
</Note>

O gráfico **Token Usage** plota input e output como uma área empilhada em 7, 14 ou 30 dias. Dias sem atividade aparecem como zero, não como lacunas.

**Top Token Consumers** lista os dez membros cuja atividade custou mais **hoje**, com contagem de solicitações e custo médio por solicitação. Só aparece quando há algo a mostrar.

<Tip>
  Um membro que fica no topo dessa lista dia após dia geralmente está postando muitas imagens. O Auto-Mod escaneia até quatro imagens por mensagem, e imagens custam muito mais que texto.
</Tip>

## Atividade

Toda solicitação de IA, das mais novas para as mais antigas, 20 por página.

| Coluna      | Notas                                                                 |
| ----------- | --------------------------------------------------------------------- |
| **Content** | A mensagem, truncada. Scans do Auto-Mod aparecem como "Auto-Mod scan" |
| **Tokens**  | Total, dividido em input e output                                     |
| **Source**  | "Auto-Mod", "AI Server Control" ou o membro que pediu                 |
| **Status**  | Completed, Failed, Blocked, Rate limited e outros                     |
| **Time**    | Relativo para entradas recentes, com data acima de um dia             |

Linhas do AI Server Control expandem para mostrar cada ação executada — um check para sucesso, um escudo para uma ação recusada, um X para um erro — e quanto tempo cada uma levou.

<Note>
  O histórico de solicitações é mantido por **30 dias**. O gráfico e o export vão até 90 dias, então gasto mais antigo continua aparecendo nos totais depois de as linhas individuais desaparecerem.
</Note>

<Warning>
  Uma execução de Server Control que expira ou dá erro é cobrada e contada nos totais, mas não gera uma linha em Activity. Se seu total do dia parecer maior do que as linhas visíveis explicam, é por isso.
</Warning>

## Export

**Export CSV** baixa os últimos **30 dias** — uma linha por dia com input, output e total de tokens, contagem de solicitações e contagem de ações. O seletor de período do gráfico não muda a janela do export.

## Recargando

**\$1 por 500.000 tokens**, em blocos de 1, 5, 10, 25, 50 ou 100 unidades.

<Steps>
  <Step title="Escolha um valor">
    A caixa de diálogo mostra o total de tokens e o preço conforme você seleciona.
  </Step>

  <Step title="Complete o checkout">
    Você é enviado para o Paddle para pagar.
  </Step>

  <Step title="Os tokens são creditados">
    A compra é adicionada ao seu pool de top-up assim que o pagamento é confirmado.
  </Step>
</Steps>

<Note>
  O botão **Top Up Tokens** só aparece se o servidor tem uma assinatura Black ativa cobrada pelo Paddle. Servidores em um tier Black concedido ou cortesia não têm método de pagamento cadastrado e não podem recarregar.
</Note>

<Warning>
  **O saldo não atualiza no instante em que você paga.** Recarregue a página após um minuto e conte um pouco a mais antes de os recursos de IA voltarem, caso já tivessem pausado.
</Warning>

<Note>
  Toda compra é creditada exatamente uma vez, mesmo se o provedor de pagamento manda a confirmação mais de uma vez. Reembolsos debitam os tokens de volta.
</Note>

## Quando o orçamento acaba

Os dois recursos param em pontos diferentes, porque uma execução do Server Control precisa de bem mais folga que um único scan de mensagem.

| Restante          | Efeito                                                              |
| ----------------- | ------------------------------------------------------------------- |
| Abaixo de 100.000 | O Auto-Mod posta um aviso único de "acabando"                       |
| Abaixo de 30.000  | **O AI Server Control recusa novas solicitações**                   |
| Abaixo de 3.000   | **A AI Auto-Moderation para de escanear** e posta um aviso de pausa |

<Warning>
  O Auto-Mod é **fail-closed**. Se ele não pode confirmar que há orçamento, não escaneia — seu servidor fica sem moderação por IA até o saldo se recuperar.
</Warning>

Os avisos são postados no seu canal de alerta do Auto-Mod, com fallback para o canal de log.

## Como manter o gasto baixo

<AccordionGroup>
  <Accordion title="Desligue o escaneamento de imagens">
    A maior economia isolada. Uma mensagem com quatro imagens custa cinco chamadas de IA em vez de uma.
  </Accordion>

  <Accordion title="Habilite Trust Tiers">
    Membros antigos e limpos passam a ser amostrados em vez de escaneados toda vez — enquanto convites, menções em massa e links continuam sempre checados.
  </Accordion>

  <Accordion title="Isente canais movimentados de baixo risco">
    Um canal de comandos de bot ou um canal de memes entre regulares confiáveis raramente precisa de scan pago.
  </Accordion>

  <Accordion title="Desabilite categorias que você não aplica">
    Uma categoria desligada nunca é avaliada.
  </Accordion>
</AccordionGroup>

## Solução de problemas

<AccordionGroup>
  <Accordion title="O saldo mostra zero em um plano Black ativo">
    Recarregue a página. Se persistir, o registro da assinatura para este servidor específico pode não estar resolvendo — verifique se o servidor aparece sob sua assinatura na página Premium.
  </Accordion>

  <Accordion title="Paguei mas o saldo não mexeu">
    Aguarde um minuto e recarregue. Se a IA já tinha pausado, pode demorar um pouco mais para voltar do que o painel demora para mostrar o novo valor.
  </Accordion>

  <Accordion title="O export abre texto cru em vez de baixar">
    É um sinal de falha de login no download. Recarregue o painel para renovar sua sessão e tente de novo.
  </Accordion>

  <Accordion title="Os tokens de hoje estão altos mas a lista de Activity parece curta">
    O Auto-Mod cobra uma chamada por mensagem mais uma por imagem, então atividade com muitas imagens multiplica rápido. Execuções falhas do Server Control também são cobradas sem deixar linha.
  </Accordion>

  <Accordion title="Posso dividir o orçamento entre os dois recursos?">
    Não — há um único pool compartilhado. Se o Auto-Mod está consumindo, aperte suas isenções ou os Trust Tiers em vez de procurar um limite por recurso.
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="AI Auto-Moderation" icon="sparkles" href="/pt/moderation/ai-auto-mod">
    De onde vem a maior parte do gasto de tokens.
  </Card>

  <Card title="IA e tokens" icon="crown" href="/pt/premium/ai">
    Como funciona a cota de IA do tier Black.
  </Card>
</CardGroup>