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

> Financez votre utilisation de l'API Venice avec du DIEM staké — 1 $ de calcul par jour et par token — frappé à partir de VVV staké ou acquis sur Base.

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](https://diem-calculator.venice.ai/) 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.

<Info>
  Pour connaître les tarifs des modèles facturés sur cette allocation, consultez la [Tarification de l'API](/overview/pricing). Pour un paiement par requête depuis un portefeuille sans clé API, consultez [x402](/guides/integrations/x402-venice-api).
</Info>

## 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](https://venice.ai/settings/api), ou via le point de terminaison [Billing Balance](/api-reference/endpoint/billing/balance).

## Obtenir du DIEM et le staker

Utilisez le tableau de bord du token à [venice.ai/token](https://venice.ai/token). Connectez un portefeuille Base — n'envoyez pas de tokens directement à une adresse de contrat.

<Steps>
  <Step title="Acquérir du VVV ou du DIEM">
    Achetez du VVV ou du DIEM sur un DEX Base tel qu'[Aerodrome](https://aerodrome.finance) ou [Uniswap](https://app.uniswap.org), ou recevez du DIEM transféré depuis un autre portefeuille.

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

  <Step title="Staker du VVV (pour frapper du DIEM)">
    Sur [venice.ai/token](https://venice.ai/token), stakez du VVV pour recevoir du sVVV. Le VVV staké génère des émissions. Le contrat de staking est [`0x321b7ff75154472B18EDb199033fF4D116F340Ff`](https://basescan.org/address/0x321b7ff75154472B18EDb199033fF4D116F340Ff#code).
  </Step>

  <Step title="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](https://diem-calculator.venice.ai/).

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

  <Step title="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**.
  </Step>

  <Step title="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](https://venice.ai/settings/api) ou le [guide de clé API](/guides/getting-started/generating-api-key).

    Les agents autonomes peuvent frapper une clé depuis un portefeuille détenant du VVV staké — consultez [Création de clé API pour agent autonome](/guides/getting-started/generating-api-key-agent).
  </Step>
</Steps>

<Warning>
  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](https://venice.ai/token) ou via un flux de transaction de staking connu.
</Warning>

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

```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"}]
  }'
```

### Vérifier le solde DIEM

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

Exemple de structure de réponse :

```json theme={"system"}
{
  "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](/api-reference/endpoint/billing/usage) et [Usage Analytics](/api-reference/endpoint/billing/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`](/api-reference/endpoint/api_keys/generate_web3_key/post).

## 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](https://venice.ai/settings/api).

## Ressources connexes

<CardGroup cols={2}>
  <Card title="Tarification de l'API" icon="coins" href="/overview/pricing">
    Tarifs par modèle facturés sur DIEM ou USD.
  </Card>

  <Card title="Token dashboard" icon="chart-line" href="https://venice.ai/token">
    Stakez du VVV, frappez du DIEM et stakez du DIEM pour du crédit API.
  </Card>

  <Card title="Clé API pour agent autonome" icon="robot" href="/guides/getting-started/generating-api-key-agent">
    Frappez une clé API depuis un portefeuille détenant du VVV staké sur Base.
  </Card>

  <Card title="Authentification portefeuille x402" icon="wallet" href="/guides/integrations/x402-venice-api">
    Payez à la requête en USDC lorsque vous ne souhaitez pas de clé API à longue durée de vie.
  </Card>

  <Card title="Solde de facturation" icon="wallet" href="/api-reference/endpoint/billing/balance">
    Lisez les soldes DIEM et USD depuis l'API.
  </Card>

  <Card title="Centre d'aide : Token" icon="book" href="https://featurebase.venice.ai/en/help/collections/2936312-token">
    Mint rate, périodes de refroidissement, rendement et autres FAQ sur le token.
  </Card>
</CardGroup>
