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

# VVV & DIEM

> Finanzia l'utilizzo della Venice API con DIEM in staking — $1 al giorno di calcolo per token — coniato da VVV in staking o acquisito su Base.

VVV e DIEM sono il livello di finanziamento on-chain di Venice per l'API. Metti in staking DIEM per ricevere un'allocazione fissa di inferenza giornaliera — **1 DIEM = \$1 al giorno** di credito Venice API — senza acquistare credito prepagato in USD per ogni richiesta.

| Token    | Ruolo                                                                                                                      |
| -------- | -------------------------------------------------------------------------------------------------------------------------- |
| **VVV**  | Il token fondamentale di Venice su Base. Mettilo in staking per guadagnare rendimento e per coniare DIEM.                  |
| **sVVV** | Ricevuta per VVV in staking. Blocca sVVV al [Mint Rate](https://diem-calculator.venice.ai/) corrente per coniare DIEM.     |
| **DIEM** | Unità di calcolo tokenizzata. Metti in staking DIEM per sbloccare un credito API giornaliero perpetuo pari a \$1 per DIEM. |

DIEM è un ERC-20 su Base. Puoi trasferirlo, scambiarlo o metterlo in staking. A differenza dei credit USD pay-as-you-go, il DIEM in staking è capacità che possiedi: l'allocazione giornaliera si rinnova a ogni epoch e non si diluisce con la crescita dell'utilizzo della rete.

<Info>
  Per le tariffe dei modelli addebitate su quell'allocazione, vedi [API Pricing](/overview/pricing). Per il pagamento per richiesta tramite wallet senza chiave API, vedi [x402](/guides/integrations/x402-venice-api).
</Info>

## Come funziona il finanziamento

Le chiavi API attingono dall'account Venice collegato in questo ordine: **DIEM**, poi bundled credits, poi USD.

Quando DIEM è la valuta attiva:

* La tua allocazione giornaliera è pari alla quantità di DIEM che hai messo in staking (1 DIEM in staking → \$1 di credito API in quell'epoch).
* Il DIEM non utilizzato in un'epoch non viene riportato. L'allocazione si rinnova alle **00:00 UTC**.
* Gli account necessitano di almeno **0.1** DIEM in staking prima che qualsiasi saldo DIEM sia spendibile.
* I costi delle richieste utilizzano lo stesso listino prezzi in USD del pay-as-you-go; DIEM è la valuta di regolamento a un tasso di 1:1 rispetto al dollaro per l'allocazione di quel giorno.

Controlla il tuo saldo DIEM corrente e della prossima epoch nella dashboard su [venice.ai/settings/api](https://venice.ai/settings/api), oppure tramite l'endpoint [Billing Balance](/api-reference/endpoint/billing/balance).

## Ottieni DIEM e mettilo in staking

Usa la token dashboard su [venice.ai/token](https://venice.ai/token). Connetti un wallet Base — non inviare token direttamente a un indirizzo di contratto.

<Steps>
  <Step title="Acquisisci VVV o DIEM">
    Acquista VVV o DIEM su un DEX di Base come [Aerodrome](https://aerodrome.finance) o [Uniswap](https://app.uniswap.org), oppure ricevi DIEM trasferito da un altro wallet.

    | Asset | Contract (Base)                                                                                                       |
    | ----- | --------------------------------------------------------------------------------------------------------------------- |
    | VVV   | [`0xacfE6019Ed1A7Dc6f7B508C02d1b04ec88cC21bf`](https://basescan.org/token/0xacfE6019Ed1A7Dc6f7B508C02d1b04ec88cC21bf) |
    | DIEM  | [`0xF4d97F2da56e8c3098f3a8D538DB630A2606a024`](https://basescan.org/token/0xF4d97F2da56e8c3098f3a8D538DB630A2606a024) |
  </Step>

  <Step title="Metti in staking VVV (se coni DIEM)">
    Su [venice.ai/token](https://venice.ai/token), metti in staking VVV per ricevere sVVV. Il VVV in staking guadagna emissioni. Il contratto di staking è [`0x321b7ff75154472B18EDb199033fF4D116F340Ff`](https://basescan.org/address/0x321b7ff75154472B18EDb199033fF4D116F340Ff#code).
  </Step>

  <Step title="Conia DIEM da sVVV (opzionale)">
    Blocca sVVV al Mint Rate corrente per coniare DIEM. Il Mint Rate è la quantità di sVVV richiesta per DIEM e aumenta con la crescita dell'offerta di DIEM — visualizzalo in anteprima sul [DIEM calculator](https://diem-calculator.venice.ai/).

    Il DIEM coniato appare nel tuo wallet come ERC-20. L'sVVV bloccato rimane bloccato finché non bruci la stessa quantità di DIEM per sbloccarlo.
  </Step>

  <Step title="Metti in staking DIEM per credito API">
    Metti in staking DIEM sulla stessa token dashboard. Ogni DIEM in staking concede **\$1 al giorno** di credito Venice API finché rimane in staking.

    Rimuovere DIEM dallo staking ha un cooldown di **1 giorno**. Sbloccare l'sVVV che ha garantito il DIEM coniato richiede di bruciare quel DIEM; rimuovere poi dallo staking l'sVVV liberato ha un cooldown di **7 giorni**.
  </Step>

  <Step title="Crea o utilizza una chiave API">
    Accedi a Venice con lo stesso wallet (Sign-In-With-Ethereum) in modo che il DIEM in staking sia collegato al tuo account, poi crea una chiave dalle [impostazioni API](https://venice.ai/settings/api) o dalla [guida alle chiavi API](/guides/getting-started/generating-api-key).

    Gli agenti autonomi possono coniare una chiave da un wallet che detiene VVV in staking — vedi [Autonomous Agent API Key Creation](/guides/getting-started/generating-api-key-agent).
  </Step>
</Steps>

<Warning>
  Non inviare mai VVV o DIEM direttamente a un indirizzo di contratto. I token inviati in quel modo non possono essere recuperati. Metti sempre in staking tramite [venice.ai/token](https://venice.ai/token) o un flusso di transazione di staking conosciuto.
</Warning>

## Utilizzare DIEM con l'API

Una volta che DIEM è in staking e collegato al tuo account, chiama l'API con una normale chiave Bearer. Non sono richiesti header aggiuntivi o `venice_parameters` — Venice deduce automaticamente da DIEM quando `consumptionCurrency` è `DIEM`.

```bash theme={"system"}
curl https://api.venice.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "venice-uncensored",
    "messages": [{"role": "user", "content": "Hello"}]
  }'
```

### Controlla il saldo DIEM

```bash theme={"system"}
curl https://api.venice.ai/api/v1/billing/balance \
  -H "Authorization: Bearer $VENICE_API_KEY"
```

Esempio di forma della risposta:

```json theme={"system"}
{
  "canConsume": true,
  "consumptionCurrency": "DIEM",
  "balances": {
    "diem": 90.5,
    "usd": 25
  },
  "diemEpochAllocation": 100
}
```

| Campo                 | Significato                                                                                                              |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| `balances.diem`       | Credito DIEM rimanente per l'epoch corrente (`null` se non stai mettendo in staking DIEM)                                |
| `diemEpochAllocation` | DIEM totale allocato per questa epoch (importo in staking). Confrontalo con `balances.diem` per vedere l'utilizzo finora |
| `consumptionCurrency` | Valuta che verrà addebitata successivamente (`DIEM`, `USD`, `BUNDLED_CREDITS` o il legacy `VCU`)                         |
| `canConsume`          | Se l'account può pagare una richiesta in questo momento                                                                  |

Elenca i modelli o le analytics di utilizzo per vedere i costi per richiesta sia in USD che in DIEM — coincidono al tasso di \$1-per-DIEM per l'allocazione del giorno. Vedi [Billing Usage](/api-reference/endpoint/billing/usage) e [Usage Analytics](/api-reference/endpoint/billing/usage-analytics).

### Limita la spesa per chiave

Quando crei una chiave, puoi impostare un limite di consumo per epoch denominato in `diem` o `usd` in modo che una singola integrazione non possa esaurire l'intera allocazione giornaliera. Le chiavi della dashboard espongono questo come **Epoch Consumption Limits**; le chiavi coniate via Web3 accettano `consumptionLimit` su [`POST /api_keys/generate_web3_key`](/api-reference/endpoint/api_keys/generate_web3_key/post).

## DIEM vs USD credits vs x402

| Percorso                | Ideale per                                                     | Come si rinnova                                                                                                                     |
| ----------------------- | -------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| **DIEM in staking**     | Capacità giornaliera prevedibile, agenti, costo AI fisso       | Allocazione completa a ogni epoch (00:00 UTC) mentre DIEM rimane in staking                                                         |
| **Credit USD / crypto** | Picchi oltre la tua allocazione DIEM, spesa prepagata semplice | Il saldo diminuisce con l'utilizzo; i credit non scadono mai                                                                        |
| **x402 (USDC)**         | Pagamento per richiesta headless senza chiave API              | Il wallet ricarica USDC tramite `POST /x402/top-up`; il DIEM su un account collegato viene comunque speso per primo quando presente |

Se una richiesta supererebbe il DIEM rimanente e nessun credito USD o bundled lo copre, l'API restituisce `402` con `INSUFFICIENT_BALANCE`. Metti in staking più DIEM, attendi la prossima epoch o aggiungi credit USD in [Settings → API](https://venice.ai/settings/api).

## Risorse correlate

<CardGroup cols={2}>
  <Card title="API Pricing" icon="coins" href="/overview/pricing">
    Tariffe per modello addebitate su DIEM o USD.
  </Card>

  <Card title="Token dashboard" icon="chart-line" href="https://venice.ai/token">
    Metti in staking VVV, conia DIEM e metti in staking DIEM per credito API.
  </Card>

  <Card title="Autonomous Agent API Key" icon="robot" href="/guides/getting-started/generating-api-key-agent">
    Conia una chiave API da un wallet con VVV in staking su Base.
  </Card>

  <Card title="x402 Wallet Auth" icon="wallet" href="/guides/integrations/x402-venice-api">
    Paga per richiesta con USDC quando non vuoi una chiave API a lunga durata.
  </Card>

  <Card title="Billing Balance" icon="wallet" href="/api-reference/endpoint/billing/balance">
    Leggi i saldi DIEM e USD dall'API.
  </Card>

  <Card title="Help Center: Token" icon="book" href="https://featurebase.venice.ai/en/help/collections/2936312-token">
    Mint rate, cooldown, rendimento e altre FAQ sui token.
  </Card>
</CardGroup>