Clés d'API

Les clés d'API authentifient vos requêtes vers l'API VocalLab. L'accès à l'API nécessite un plan Pro ou supérieur.

Créer une clé

1. Allez dans les Paramètres développeur.
2. Saisissez un nom (par ex. « Production » ou « Zapier ») et cliquez sur Créer une clé.
3. Copiez la clé immédiatement — elle commence par vl_live_ et ne s'affiche qu'une seule fois. Nous n'en stockons qu'une version hachée et ne pouvons pas l'afficher à nouveau.

Utiliser une clé

Envoyez-la en tant que jeton Bearer à chaque requête :

curl https://api.vocallab.ai/api/v1/ping \
  -H "Authorization: Bearer vl_live_..."

Révoquer une clé

Dans les Paramètres développeur, cliquez sur Révoquer à côté d'une clé. Elle cesse de fonctionner immédiatement. Si une clé est divulguée, révoquez-la et créez-en une nouvelle.

Bonnes pratiques

• Stockez les clés dans des variables d'environnement ou un gestionnaire de secrets — jamais dans le code ou git.
• Utilisez une clé distincte par application ou intégration, afin de pouvoir en révoquer une sans affecter les autres.
• Si votre plan repasse sous Pro, les clés cessent de fonctionner jusqu'à ce que vous soyez de nouveau sur Pro ou supérieur (elles ne sont pas supprimées).

Limites

• Jusqu'à 5 clés actives par compte.
• 60 requêtes par minute par clé.