# Crediti e utilizzo

Che cos’è un credito, cosa ne consuma uno e come far durare il saldo.

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

I crediti sono l’unità di utilizzo della piattaforma Beeuni. Ogni account ha un saldo di crediti, che diminuisce quando si eseguono attività. Più un’attività è complessa o lunga, più crediti richiede.

Le chiamate ai modelli sono il fattore principale. I crediti vengono spesi per i token di input (il tuo prompt e il contesto circostante) e per i token di output (ciò che l’agente scrive in risposta); la tariffa dipende dal livello del modello scelto per la sessione. La fatturazione e il saldo sono a livello di account: vedi [Account e accesso](/docs/it/accounts#billing).

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

## Due tipi di credito

Un account può averli entrambi contemporaneamente, ma funzionano in modo diverso:

- **Crediti con scadenza** — 20 $ iniziali, validi per 30 giorni; poi 2 $ per periodo mensile, senza accumulo. Anche i crediti degli abbonamenti a pagamento scadono alla fine del ciclo di fatturazione. Coprono il funzionamento del computer e i modelli ufficiali.
- **Crediti senza scadenza** — i crediti acquistati sono conservati separatamente e si accumulano. Anche i rimborsi e altre assegnazioni possono rientrare in questa categoria; il credito iniziale no.

> **Ordine di utilizzo**
>
> I crediti con scadenza vengono sempre usati per primi. Quelli senza scadenza vengono utilizzati solo quando il saldo dei crediti con scadenza arriva a zero, così la quota mensile non può mai consumare senza che tu te ne accorga una ricarica che hai pagato.

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

## Come ottenere altri crediti

| Fonte | Tipo | Come ottenerli |
|---|---|---|
| Crediti mensili dell’abbonamento | Con scadenza | Inclusi in un piano a pagamento, rinnovati automaticamente ogni mese. |
| Crediti di ricarica | Senza scadenza | Acquistabili quando ne hai bisogno. Disponibili per i membri premium. |
| Crediti promozionali e per eventi | Senza scadenza | Crediti bonus provenienti da eventi, promozioni o referral. |
| Rimborsi | Senza scadenza | Crediti restituiti dopo un problema tecnico o un’attività non riuscita. |

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

## Quando vengono accreditati i crediti a pagamento

I crediti vengono accreditati quando il pagamento è stato saldato. Un pagamento accettato ma non ancora saldato non aumenta il saldo fino al suo effettivo saldo.

- **Ricariche pagate tramite addebito bancario** — i pagamenti con carta vengono saldati subito. Un addebito bancario (per esempio ACH) può richiedere diversi giorni lavorativi; i crediti arrivano al momento del saldo. Se l’addebito non va a buon fine, non viene aggiunto nulla.
- **Ricarica automatica** — vale la stessa regola. Mentre una ricarica tramite addebito bancario è ancora in fase di saldo, la ricarica automatica non avvia un secondo addebito.
- **Aggiunta di posti durante il ciclo** — ogni posto aggiunto viene addebitato subito, in proporzione al periodo restante del ciclo di fatturazione. Una volta pagato l’addebito, il saldo aumenta della stessa quota proporzionale dell’assegnazione mensile di crediti del posto.
- **Rimozione di posti durante il ciclo** — il numero ridotto di posti viene fatturato a partire dal rinnovo successivo. La parte inutilizzata del ciclo corrente non viene rimborsata e i crediti già assegnati restano nel saldo.
- **Passaggio a un piano superiore durante il ciclo** — la differenza di prezzo viene addebitata subito e l’upgrade si applica solo quando il pagamento va a buon fine. Il saldo aumenta quindi della quota proporzionale dell’assegnazione mensile di crediti del nuovo piano. Al rinnovo successivo viene assegnata l’intera quota.

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

## Se la ricarica automatica non va a buon fine

La ricarica automatica addebita il metodo di pagamento salvato quando il saldo scende sotto la soglia impostata.

- Un addebito non riuscito per un motivo temporaneo viene ritentato con un addebito successivo: non prima di 5 minuti dal primo errore e di 30 minuti dal secondo.
- Un rifiuto definitivo (per esempio, fondi insufficienti o carta scaduta) o il terzo addebito fallito di seguito disattivano la ricarica automatica, interrompendo gli addebiti.
- In tal caso, ogni proprietario dell’account riceve un’email con il motivo e **Settings → Billing** mostra il motivo accanto all’interruttore. Aggiorna il metodo di pagamento, quindi riattiva la ricarica automatica.
- Quando il saldo raggiunge $0, gli agenti si mettono in pausa finché l’account non viene ricaricato. Con un piano a pagamento e la ricarica automatica disattivata, ogni proprietario riceve un’email la prima volta che il saldo raggiunge $0 in ciascun giorno.
  Un membro che non può aggiungere crediti può premere **Ask an owner** nell’avviso di crediti esauriti: ogni proprietario riceve un’email con il saldo e un link a Billing. Ogni membro può inviare una richiesta al giorno.

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

## Monitorare l’utilizzo

Nelle impostazioni ci sono due sezioni, per due esigenze diverse:

- **Settings → Billing** — il saldo attuale, suddiviso tra crediti con e senza scadenza.
- **Settings → Usage** — il consumo per thread e conversazione, utile per individuare le sessioni più costose.

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

## Far durare il saldo

- **Scegli il modello adatto al lavoro.** Affida le attività semplici a un modello più piccolo e riserva il livello più avanzato alle attività che richiedono ragionamento. La differenza di tariffa tra i livelli è molto maggiore della differenza nella qualità dei risultati per un’attività semplice.
- **Dai istruzioni chiare.** Definire bene un’attività riduce gli scambi con l’agente, e ogni scambio comporta token.
- **Controlla la scheda Usage.** Individua le conversazioni che consumano di più e intervieni prima su quelle.
- **Resta nello stesso thread.** Più turni nello stesso thread sfruttano la memorizzazione nella cache dei prompt, riducendo notevolmente il costo dei token.

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

## Se un importo non sembra corretto

Se una cifra qui non corrisponde a quanto ti è stato addebitato, scrivi a
[hello@valkorai.com](mailto:hello@valkorai.com) oppure chiedi su
[Discord](https://discord.com/invite/Yr7UjwbYPC). Ci impegniamo a garantire una fatturazione equa e
trasparente: se ritieni che ci sia un errore nell’utilizzo dei tuoi crediti,
contatta l’assistenza e faremo tempestivamente le verifiche.