> ## 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.

# Utilizzo IA

> Saldo dei token, spesa nel tempo, cronologia delle richieste e ricariche.

<Info>
  **Solo tier Black.** Un unico budget condiviso copre [AI Auto-Moderation](/it/moderation/ai-auto-mod) e [AI Server Control](/it/moderation/ai-server-control) — non c'è una quota separata per funzionalità.
</Info>

## Due bacini

Il tuo saldo è la somma di due bacini, spesi in questo ordine:

<CardGroup cols={2}>
  <Card title="Grant mensile" icon="calendar">
    **10.000.000 token**, ricaricati con un ciclo di 30 giorni. I token non usati **non** vengono cumulati.
  </Card>

  <Card title="Ricarica" icon="plus">
    Token che hai acquistato. **Non scadono mai**, e sopravvivono a rinnovi e cambi di piano.
  </Card>
</CardGroup>

Il grant viene sempre consumato per primo, quindi una ricarica è una vera riserva invece di qualcosa che si esaurisce silenziosamente ogni mese.

<Warning>
  **Il valore "Resets in" segue la tua data di fatturazione, non il ciclo del grant.** Su un abbonamento Black annuale può leggere diverse centinaia di giorni mentre il grant si sta effettivamente ricaricando ogni 30 giorni.

  Osserva il numero **Monthly grant** stesso — quando torna a 10.000.000, il ciclo è avanzato.
</Warning>

## Panoramica

| Tile                       | Cosa conta                                                   |
| -------------------------- | ------------------------------------------------------------ |
| **Token Balance**          | Grant più ricarica — quello che puoi effettivamente spendere |
| **Tokens Used Today**      | Oggi fin qui, in UTC                                         |
| **Tokens Used This Month** | Mese solare fino ad oggi                                     |
| **Requests Today**         | Numero di chiamate AI, non token                             |
| **Input / output tokens**  | Suddivisi per oggi e per questo mese                         |

<Note>
  I giorni scattano a **mezzanotte UTC**, non nel fuso orario del tuo server.
</Note>

<Note>
  Le cifre mensili sono in cache fino a cinque minuti. Subito dopo un'attività intensa i tile giornalieri si aggiornano prima di quelli mensili — non sono in disaccordo, si aggiornano a ritmi diversi.
</Note>

Il grafico **Token Usage** traccia input e output come area impilata su 7, 14 o 30 giorni. I giorni senza attività appaiono come zero invece che come vuoti.

**Top Token Consumers** elenca i dieci membri la cui attività è costata di più **oggi**, con il conteggio delle richieste e il costo medio per richiesta. Appare solo quando c'è qualcosa da mostrare.

<Tip>
  Un membro seduto in cima a quella lista giorno dopo giorno di solito posta molte immagini. L'Auto-Mod scansiona fino a quattro immagini per messaggio, e le immagini costano molto più del testo.
</Tip>

## Attività

Ogni richiesta AI, dalla più recente, 20 per pagina.

| Colonna     | Note                                                                        |
| ----------- | --------------------------------------------------------------------------- |
| **Content** | Il messaggio, troncato. Le scansioni Auto-Mod appaiono come "Auto-Mod scan" |
| **Tokens**  | Totale, suddiviso in input e output                                         |
| **Source**  | "Auto-Mod", "AI Server Control", o il membro che ha chiesto                 |
| **Status**  | Completed, Failed, Blocked, Rate limited e altri                            |
| **Time**    | Relativo per le voci recenti, datato oltre un giorno                        |

Le righe di AI Server Control si espandono per mostrare ogni azione eseguita — una spunta per il successo, uno scudo per un'azione rifiutata, una croce per un errore — e il tempo di ciascuna.

<Note>
  La cronologia delle richieste viene conservata per **30 giorni**. Il grafico e l'esportazione risalgono fino a 90 giorni, quindi la spesa più vecchia appare comunque nei totali dopo che le singole righe sono sparite.
</Note>

<Warning>
  Un'esecuzione di Server Control che va in timeout o in errore viene fatturata e conteggiata nei totali ma non produce una riga di Attività. Se il tuo totale giornaliero sembra più alto di quanto spieghino le righe visibili, è per questo.
</Warning>

## Esportazione

**Export CSV** scarica gli ultimi **30 giorni** — una riga per giorno con token di input, output e totali, conteggio delle richieste e delle azioni. Il selettore del periodo del grafico non cambia la finestra di esportazione.

## Ricarica

**\$1 per 500.000 token**, in blocchi di 1, 5, 10, 25, 50 o 100 unità.

<Steps>
  <Step title="Scegli un importo">
    Il dialogo mostra il totale dei token e il prezzo mentre selezioni.
  </Step>

  <Step title="Completa il checkout">
    Vieni inviato a Paddle per pagare.
  </Step>

  <Step title="I token vengono accreditati">
    L'acquisto viene aggiunto al tuo bacino di ricarica una volta confermato il pagamento.
  </Step>
</Steps>

<Note>
  Il pulsante **Top Up Tokens** appare solo se il server ha un abbonamento Black attivo fatturato tramite Paddle. I server su un tier Black concesso o omaggio non hanno un metodo di pagamento in archivio e non possono ricaricare.
</Note>

<Warning>
  **Il saldo non si aggiorna nell'istante in cui paghi.** Ricarica la pagina dopo un minuto, e concedi un po' più di tempo prima che le funzionalità AI riprendano se si erano già messe in pausa.
</Warning>

<Note>
  Ogni acquisto viene accreditato esattamente una volta, anche se il provider di pagamento invia la conferma più di una volta. I rimborsi ridebitano i token.
</Note>

## Quando il budget si esaurisce

Le due funzionalità si fermano in punti diversi, perché un'esecuzione di Server Control ha bisogno di molto più margine di una singola scansione di messaggio.

| Rimanenti     | Effetto                                                                    |
| ------------- | -------------------------------------------------------------------------- |
| Sotto 100.000 | Auto-Mod pubblica un avviso una tantum "in esaurimento"                    |
| Sotto 30.000  | **AI Server Control rifiuta nuove richieste**                              |
| Sotto 3.000   | **AI Auto-Moderation smette di scansionare** e pubblica un avviso di pausa |

<Warning>
  Auto-Mod è **fail-closed**. Se non può confermare che c'è budget non scansiona — il tuo server non ha alcuna moderazione AI finché il saldo non si riprende.
</Warning>

Gli avvisi vengono pubblicati nel tuo canale alert dell'Auto-Mod, con fallback al canale log.

## Tenere bassa la spesa

<AccordionGroup>
  <Accordion title="Disattiva la scansione delle immagini">
    Il singolo risparmio più grande. Un messaggio con quattro immagini costa cinque chiamate AI invece di una.
  </Accordion>

  <Accordion title="Abilita i Trust Tiers">
    I membri fedeli e puliti vengono campionati invece che scansionati ogni volta — mentre inviti, menzioni di massa e link sono comunque sempre controllati.
  </Accordion>

  <Accordion title="Esenta canali a basso rischio molto attivi">
    Un canale bot-comandi, o un canale meme tra frequentatori fidati, raramente ha bisogno di scansioni a pagamento.
  </Accordion>

  <Accordion title="Disabilita le categorie che non applichi">
    Una categoria disattivata non viene mai valutata.
  </Accordion>
</AccordionGroup>

## Risoluzione dei problemi

<AccordionGroup>
  <Accordion title="Il saldo mostra zero su un piano Black attivo">
    Ricarica la pagina. Se persiste, il record dell'abbonamento per questo specifico server potrebbe non risolversi — verifica che il server compaia sotto il tuo abbonamento nella pagina Premium.
  </Accordion>

  <Accordion title="Ho pagato ma il saldo non si è mosso">
    Dagli un minuto e ricarica. Se l'AI era già in pausa può volerci un po' più a lungo per riprendere rispetto a quanto impiega la dashboard a mostrare il nuovo valore.
  </Accordion>

  <Accordion title="L'esportazione apre testo grezzo invece di scaricare">
    È un errore di login sul download. Ricarica la dashboard così la tua sessione si aggiorna, poi riprova.
  </Accordion>

  <Accordion title="I token di oggi sono alti ma la lista Attività sembra corta">
    L'Auto-Mod fattura una chiamata per messaggio più una per immagine, quindi l'attività con molte immagini si moltiplica rapidamente. Anche le esecuzioni Server Control fallite sono fatturate senza lasciare una riga.
  </Accordion>

  <Accordion title="Posso dividere il budget tra le due funzionalità?">
    No — c'è un solo bacino condiviso. Se l'Auto-Mod lo sta consumando, stringi le sue esenzioni o i Trust Tiers invece di cercare un cap per-funzionalità.
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="AI Auto-Moderation" icon="sparkles" href="/it/moderation/ai-auto-mod">
    Da dove proviene la maggior parte della spesa in token.
  </Card>

  <Card title="AI e token" icon="crown" href="/it/premium/ai">
    Come funziona la quota AI del tier Black.
  </Card>
</CardGroup>