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

# Génération d'une clé API

> Créez une clé d'API Venice depuis le tableau de bord, stockez le bearer token en toute sécurité et vérifiez son fonctionnement avec une première requête de complétions de chat authentifiée.

Les requêtes à l'API Venice sont authentifiées avec des clés API Bearer. Ce guide explique comment créer une clé depuis le tableau de bord Venice, la stocker en toute sécurité et vérifier qu'elle fonctionne.

<Note>
  Si vous développez un agent autonome qui doit générer sa propre clé avec un portefeuille, utilisez plutôt le guide [Création de clé API pour agent autonome](/guides/getting-started/generating-api-key-agent).
</Note>

## Avant de commencer

* Connectez-vous à votre compte Venice.
* Assurez-vous que le compte dispose d'un solde utilisable avant d'appeler des endpoints payants. Vous pouvez créer une clé avant de financer le compte, mais les requêtes aux modèles n'aboutiront pas tant que le compte ne peut pas consommer de DIEM, de crédits groupés ou d'USD.

<Steps>
  <Step title="Ouvrir les paramètres API">
    Rendez-vous sur [https://venice.ai/settings/api](https://venice.ai/settings/api). Vous pouvez également ouvrir cette page depuis l'application Venice en sélectionnant **API** dans vos paramètres.

    Le tableau de bord des paramètres API affiche vos soldes, votre niveau d'API, votre utilisation et vos clés API existantes.
  </Step>

  <Step title="Démarrer la création d'une nouvelle clé">
    Sélectionnez **Generate New API Key**, puis configurez la clé :

    * **Description :** utilisez un nom court qui identifie l'application, l'environnement ou l'intégration qui utilisera cette clé.
    * **API Key Type :** utilisez **Inference Only** pour les requêtes normales aux modèles. Utilisez **Admin** uniquement lorsque la clé doit gérer les clés API de manière programmatique.
    * **Expires at :** définissez éventuellement une date d'expiration. Si vous laissez ce champ vide, la clé n'expire pas automatiquement.
    * **Epoch Consumption Limits :** limitez éventuellement le montant en DIEM ou en USD que cette clé peut dépenser pendant une période de 24 heures (epoch). Si vous laissez ce champ vide, la clé peut utiliser le solde disponible du compte, dans la limite des plafonds de votre compte.
  </Step>

  <Step title="Générer et copier la clé">
    Cliquez sur **Generate**. Venice affichera la clé API complète une seule fois.

    <Warning>
      Copiez la clé immédiatement et stockez-la dans un endroit sécurisé. Une fois la boîte de dialogue fermée, Venice n'affiche plus que des métadonnées d'identification telles que la description de la clé et ses derniers caractères. Si vous perdez la valeur secrète, supprimez la clé et créez-en une nouvelle.
    </Warning>

    Ajoutez la clé à votre environnement local ou à votre gestionnaire de secrets :

    ```bash theme={null}
    export VENICE_API_KEY="your-api-key-here"
    ```
  </Step>

  <Step title="Vérifier la clé">
    Effectuez une requête à faible risque pour confirmer que l'authentification fonctionne :

    ```bash theme={null}
    curl --request GET \
      --url https://api.venice.ai/api/v1/models \
      --header "Authorization: Bearer $VENICE_API_KEY"
    ```

    Une réponse réussie renvoie les modèles disponibles. Si vous recevez une erreur d'authentification, vérifiez que la clé a été copiée intégralement et que l'en-tête `Authorization` est au format `Bearer <api-key>`.
  </Step>
</Steps>

## Bonnes pratiques

* Créez des clés distinctes pour le développement, la préproduction et la production.
* Privilégiez les clés **Inference Only** pour les applications qui appellent uniquement les endpoints de modèles.
* Limitez l'usage des clés **Admin**, en restreignant strictement leur portée et en les stockant uniquement dans des environnements serveur de confiance.
* Ne committez jamais de clés API dans un système de gestion de versions et ne les exposez jamais dans du code côté client.
* Définissez des dates d'expiration et des limites de consommation pour les clés utilisées dans des environnements temporaires, partagés ou à plus haut risque.
* Supprimez les clés inutilisées et faites tourner toute clé susceptible d'avoir été exposée.

## Gestion programmatique des clés

Les clés Admin peuvent gérer les clés API via les endpoints de la référence API :

<CardGroup cols={2}>
  <Card title="Créer une clé API" icon="plus" href="/api-reference/endpoint/api_keys/create">
    Créez une nouvelle clé API de type tableau de bord à partir d'une clé admin existante.
  </Card>

  <Card title="Lister les clés API" icon="list" href="/api-reference/endpoint/api_keys/list">
    Consultez les clés actives et leurs métadonnées.
  </Card>

  <Card title="Mettre à jour une clé API" icon="pen-to-square" href="/api-reference/endpoint/api_keys/update">
    Mettez à jour la description, la date d'expiration ou les limites de consommation d'une clé.
  </Card>

  <Card title="Supprimer une clé API" icon="trash" href="/api-reference/endpoint/api_keys/delete">
    Révoquez une clé qui n'est plus nécessaire.
  </Card>
</CardGroup>