Passer au contenu principal
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.
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.

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

Ouvrir les paramètres API

Rendez-vous sur 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.
2

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

Générer et copier la clé

Cliquez sur Generate. Venice affichera la clé API complète une seule fois.
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.
Ajoutez la clé à votre environnement local ou à votre gestionnaire de secrets :
export VENICE_API_KEY="your-api-key-here"
4

Vérifier la clé

Effectuez une requête à faible risque pour confirmer que l’authentification fonctionne :
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>.

​
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 :

Créer une clé API

Créez une nouvelle clé API de type tableau de bord à partir d’une clé admin existante.

Lister les clés API

Consultez les clés actives et leurs métadonnées.

Mettre à jour une clé API

Mettez à jour la description, la date d’expiration ou les limites de consommation d’une clé.

Supprimer une clé API

Révoquez une clé qui n’est plus nécessaire.