> ## Documentation Index
> Fetch the complete documentation index at: https://veniceai-docs-responses-api.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# VVV & DIEM

> Finanzia l'inferenza dell'API Venice con token DIEM in staking, $1 di calcolo al giorno ciascuno, coniati facendo staking di VVV su Base con quota giornaliera.

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 — senza acquistare credito prepagato in USD per ogni richiesta.

| Token | Ruolo |
| - | - |
| **[VVV](https://venice.ai/lp/vvv?utm_source=venice-api-documentation)** | 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](https://venice.ai/lp/diem?utm_source=venice-api-documentation)** | Unità di calcolo tokenizzata. Metti in staking DIEM per sbloccare un credito Venice 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 Venice 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?utm_source=venice-api-documentation), 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?utm_source=venice-api-documentation). La dashboard si trova nell'app Venice e richiede un account Venice con un wallet Base collegato. 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?utm_source=venice-api-documentation), 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 Venice">
    Metti in staking DIEM sulla stessa token dashboard. Ogni DIEM in staking concede **\$1 al giorno** di credito Venice 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?utm_source=venice-api-documentation) 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/integrations/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?utm_source=venice-api-documentation) 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={null}
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={null}
curl https://api.venice.ai/api/v1/billing/balance \
  -H "Authorization: Bearer $VENICE_API_KEY"
```

Esempio di forma della risposta:

```json theme={null}
{
  "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?utm_source=venice-api-documentation).

## 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?utm_source=venice-api-documentation">
    Metti in staking VVV, conia DIEM e metti in staking DIEM per credito Venice. Richiede un account Venice con un wallet Base collegato.
  </Card>

  <Card title="Autonomous Agent API Key" icon="robot" href="/guides/integrations/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="Panoramica VVV e DIEM" icon="circle-info" href="https://venice.ai/lp/vvv?utm_source=venice-api-documentation">
    Panoramica pubblica del modello di token di Venice e di come il DIEM diventa inferenza.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.