VVV & DIEM | Venice API Docs

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

Per le tariffe dei modelli addebitate su quell’allocazione, vedi API Pricing. Per il pagamento per richiesta tramite wallet senza chiave API, vedi x402.

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, oppure tramite l’endpoint Billing Balance.

Ottieni DIEM e mettilo in staking

Usa la token dashboard su venice.ai/token. Connetti un wallet Base — non inviare token direttamente a un indirizzo di contratto.

Acquisisci VVV o DIEM

Acquista VVV o DIEM su un DEX di Base come Aerodrome o Uniswap, oppure ricevi DIEM trasferito da un altro wallet.

Asset	Contract (Base)
VVV	`0xacfE6019Ed1A7Dc6f7B508C02d1b04ec88cC21bf`
DIEM	`0xF4d97F2da56e8c3098f3a8D538DB630A2606a024`

Metti in staking VVV (se coni DIEM)

Su venice.ai/token, metti in staking VVV per ricevere sVVV. Il VVV in staking guadagna emissioni. Il contratto di staking è 0x321b7ff75154472B18EDb199033fF4D116F340Ff.

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

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.

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 o dalla guida alle chiavi API.Gli agenti autonomi possono coniare una chiave da un wallet che detiene VVV in staking — vedi Autonomous Agent API Key Creation.

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 o un flusso di transazione di staking conosciuto.

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.

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

curl https://api.venice.ai/api/v1/billing/balance \
  -H "Authorization: Bearer $VENICE_API_KEY"

Esempio di forma della risposta:

{
  "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 e 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.

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.

Risorse correlate

API Pricing

Tariffe per modello addebitate su DIEM o USD.

Token dashboard

Metti in staking VVV, conia DIEM e metti in staking DIEM per credito API.

Autonomous Agent API Key

Conia una chiave API da un wallet con VVV in staking su Base.

x402 Wallet Auth

Paga per richiesta con USDC quando non vuoi una chiave API a lunga durata.

Billing Balance

Leggi i saldi DIEM e USD dall’API.

Help Center: Token

Mint rate, cooldown, rendimento e altre FAQ sui token.

​Come funziona il finanziamento

​Ottieni DIEM e mettilo in staking

​Utilizzare DIEM con l’API

​Controlla il saldo DIEM

​Limita la spesa per chiave

​DIEM vs USD credits vs x402

​Risorse correlate

API Pricing

Token dashboard

Autonomous Agent API Key

x402 Wallet Auth

Billing Balance

Help Center: Token

Come funziona il finanziamento

Ottieni DIEM e mettilo in staking

Utilizzare DIEM con l’API

Controlla il saldo DIEM

Limita la spesa per chiave

DIEM vs USD credits vs x402

Risorse correlate