VVV & DIEM | Documentation de l'API Venice

VVV et DIEM constituent la couche de financement on-chain de Venice pour l’API. Stakez du DIEM pour recevoir une allocation d’inférence quotidienne fixe — 1 DIEM = 1 $ par jour de crédit pour l’API Venice — sans avoir à acheter des crédits USD prépayés pour chaque requête.

Token	Rôle
VVV	Le token fondamental de Venice sur Base. Stakez-le pour générer du rendement et frapper du DIEM.
sVVV	Reçu pour le VVV staké. Verrouillez du sVVV au Mint Rate actuel pour frapper du DIEM.
DIEM	Unité de calcul tokenisée. Stakez du DIEM pour débloquer un crédit API quotidien perpétuel égal à 1 $ par DIEM.

DIEM est un ERC-20 sur Base. Vous pouvez le transférer, l’échanger ou le staker. Contrairement aux crédits USD à la demande, le DIEM staké est une capacité que vous possédez : l’allocation quotidienne se renouvelle à chaque époque et ne se dilue pas à mesure que l’utilisation du réseau augmente.

Pour connaître les tarifs des modèles facturés sur cette allocation, consultez la Tarification de l’API. Pour un paiement par requête depuis un portefeuille sans clé API, consultez x402.

Fonctionnement du financement

Les clés API dépensent depuis le compte Venice associé dans cet ordre : DIEM, puis crédits groupés, puis USD. Lorsque DIEM est la devise active :

Votre allocation quotidienne équivaut au montant de DIEM que vous avez staké (1 DIEM staké → 1 $ de crédit API pour cette époque).
Le DIEM non utilisé au cours d’une époque n’est pas reporté. L’allocation se renouvelle à 00:00 UTC.
Les comptes ont besoin d’au moins 0,1 DIEM staké avant que tout solde DIEM ne soit dépensable.
Les coûts des requêtes utilisent la même grille tarifaire en USD que le paiement à la demande ; DIEM est la devise de règlement à un taux de 1:1 par rapport au dollar pour l’allocation de la journée.

Consultez votre solde DIEM actuel et celui de la prochaine époque dans le tableau de bord à venice.ai/settings/api, ou via le point de terminaison Billing Balance.

Obtenir du DIEM et le staker

Utilisez le tableau de bord du token à venice.ai/token. Connectez un portefeuille Base — n’envoyez pas de tokens directement à une adresse de contrat.

Acquérir du VVV ou du DIEM

Achetez du VVV ou du DIEM sur un DEX Base tel qu’Aerodrome ou Uniswap, ou recevez du DIEM transféré depuis un autre portefeuille.

Actif	Contrat (Base)
VVV	`0xacfE6019Ed1A7Dc6f7B508C02d1b04ec88cC21bf`
DIEM	`0xF4d97F2da56e8c3098f3a8D538DB630A2606a024`

Staker du VVV (pour frapper du DIEM)

Sur venice.ai/token, stakez du VVV pour recevoir du sVVV. Le VVV staké génère des émissions. Le contrat de staking est 0x321b7ff75154472B18EDb199033fF4D116F340Ff.

Frapper du DIEM à partir du sVVV (facultatif)

Verrouillez du sVVV au Mint Rate actuel pour frapper du DIEM. Le Mint Rate correspond à la quantité de sVVV requise par DIEM et augmente à mesure que l’offre de DIEM croît — prévisualisez-le sur le calculateur DIEM.Le DIEM frappé apparaît dans votre portefeuille en tant qu’ERC-20. Le sVVV verrouillé reste verrouillé jusqu’à ce que vous brûliez le même montant de DIEM pour le débloquer.

Staker du DIEM pour du crédit API

Stakez du DIEM sur le même tableau de bord du token. Chaque DIEM staké donne droit à 1 $ par jour de crédit pour l’API Venice tant qu’il reste staké.Le retrait de stake du DIEM comporte une période de refroidissement de 1 jour. Le déverrouillage du sVVV qui a servi à frapper du DIEM nécessite de brûler ce DIEM ; le retrait de stake du sVVV ainsi libéré comporte ensuite une période de refroidissement de 7 jours.

Créer ou utiliser une clé API

Connectez-vous à Venice avec le même portefeuille (Sign-In-With-Ethereum) afin que le DIEM staké soit rattaché à votre compte, puis créez une clé depuis les paramètres de l’API ou le guide de clé API.Les agents autonomes peuvent frapper une clé depuis un portefeuille détenant du VVV staké — consultez Création de clé API pour agent autonome.

N’envoyez jamais de VVV ou de DIEM directement à une adresse de contrat. Les tokens envoyés de cette manière ne peuvent pas être récupérés. Stakez toujours via venice.ai/token ou via un flux de transaction de staking connu.

Utiliser DIEM avec l’API

Une fois que du DIEM est staké et lié à votre compte, appelez l’API avec une clé Bearer normale. Aucun en-tête supplémentaire ni venice_parameters n’est requis — Venice déduit automatiquement depuis DIEM lorsque consumptionCurrency est 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"}]
  }'

Vérifier le solde DIEM

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

Exemple de structure de réponse :

{
  "canConsume": true,
  "consumptionCurrency": "DIEM",
  "balances": {
    "diem": 90.5,
    "usd": 25
  },
  "diemEpochAllocation": 100
}

Champ	Signification
`balances.diem`	Crédit DIEM restant pour l’époque actuelle (`null` si vous ne stakez pas de DIEM)
`diemEpochAllocation`	Total de DIEM alloué pour cette époque (montant staké). Comparez-le à `balances.diem` pour connaître l’utilisation jusqu’à présent
`consumptionCurrency`	Devise qui sera facturée ensuite (`DIEM`, `USD`, `BUNDLED_CREDITS`, ou l’ancienne `VCU`)
`canConsume`	Indique si le compte peut payer une requête à cet instant

Listez les modèles ou les analyses d’utilisation pour voir les coûts par requête à la fois en USD et en DIEM — ils correspondent au taux de 1 $ par DIEM pour l’allocation de la journée. Consultez Billing Usage et Usage Analytics.

Plafonner la dépense par clé

Lors de la création d’une clé, vous pouvez définir une limite de consommation par époque libellée en diem ou usd afin qu’une intégration unique ne puisse pas épuiser la totalité de l’allocation quotidienne. Les clés du tableau de bord exposent ceci sous le nom Epoch Consumption Limits ; les clés frappées via Web3 acceptent consumptionLimit sur POST /api_keys/generate_web3_key.

DIEM vs crédits USD vs x402

Voie	Idéal pour	Mode de renouvellement
DIEM staké	Capacité quotidienne prévisible, agents, coût fixe de l’IA	Allocation complète à chaque époque (00:00 UTC) tant que le DIEM reste staké
Crédits USD / crypto	Pics dépassant votre allocation DIEM, dépense prépayée simple	Le solde diminue avec l’utilisation ; les crédits n’expirent jamais
x402 (USDC)	Paiement par requête sans clé API, en mode headless	Le portefeuille recharge en USDC via `POST /x402/top-up` ; le DIEM sur un compte lié est toujours dépensé en premier lorsqu’il est présent

Si une requête dépasse le DIEM restant et qu’aucun crédit USD ou groupé ne la couvre, l’API renvoie 402 avec INSUFFICIENT_BALANCE. Stakez plus de DIEM, attendez la prochaine époque ou ajoutez des crédits USD dans Paramètres → API.

Ressources connexes

Tarification de l'API

Tarifs par modèle facturés sur DIEM ou USD.

Token dashboard

Stakez du VVV, frappez du DIEM et stakez du DIEM pour du crédit API.

Clé API pour agent autonome

Frappez une clé API depuis un portefeuille détenant du VVV staké sur Base.

Authentification portefeuille x402

Payez à la requête en USDC lorsque vous ne souhaitez pas de clé API à longue durée de vie.

Solde de facturation

Lisez les soldes DIEM et USD depuis l’API.

Centre d'aide : Token

Mint rate, périodes de refroidissement, rendement et autres FAQ sur le token.

​Fonctionnement du financement

​Obtenir du DIEM et le staker

​Utiliser DIEM avec l’API

​Vérifier le solde DIEM

​Plafonner la dépense par clé

​DIEM vs crédits USD vs x402

​Ressources connexes

Tarification de l'API

Token dashboard

Clé API pour agent autonome

Authentification portefeuille x402

Solde de facturation

Centre d'aide : Token

Fonctionnement du financement

Obtenir du DIEM et le staker

Utiliser DIEM avec l’API

Vérifier le solde DIEM

Plafonner la dépense par clé

DIEM vs crédits USD vs x402

Ressources connexes