Présentation de l'API

L'API VocalLab vous permet de générer de la voix, de lister les voix et de consulter votre solde par programmation — depuis vos propres applications, scripts ou outils d'automatisation.

Regarder le tutoriel complet · en anglais

Plan Pro ou supérieur requis. L'accès à l'API est inclus à partir de Pro. Créez une clé dans les Paramètres développeur.

URL de base

https://api.vocallab.ai

Authentification

Envoyez votre clé d'API en tant que jeton Bearer à chaque requête :

Authorization: Bearer vl_live_...

Les clés sont créées et révoquées sur la page Développeur. Traitez une clé comme un mot de passe — elle s'affiche une seule fois, et quiconque la possède peut dépenser vos points. Voir Clés d'API.

Ce que vous pouvez faire

• Générer de la voix — POST /api/v1/tts (avec un model en option)
• Lister les voix — GET /api/v1/voices (catalogue + vos voix clonées et conçues)
• Lister les modèles — GET /api/v1/models (VocalLab Studio / Pro / Lite)
• Vérifier le statut / obtenir l'URL hébergée — GET /api/v1/tts/:id
• Télécharger les sous-titres SRT — GET /api/v1/tts/:id/captions (lignes de sous-titres ou mot à mot)
• Concevoir une voix — POST /api/v1/voices/designs/previews, puis POST /api/v1/voices/designs pour la conserver
• Cloner une voix — POST /api/v1/voices/clones (un court enregistrement, envoyé en base64)
• Consulter votre solde — GET /api/v1/ping ou GET /api/v1/me

Choisir un modèle

Passez "model" sur POST /api/v1/tts pour choisir le moteur (par défaut v-pro) :

• v-studio — VocalLab Studio : le plus récent, orientable (suit les instructions d'expression), plus de 200 langues.
• v-flash — VocalLab Studio Flash : les mêmes 200+ langues, environ 5× plus rapide, facturé ¾ des points. Non orientable.
• v-pro — VocalLab Pro : fidélité maximale, 15 langues. Le modèle par défaut.
• v-lite — VocalLab Lite : rapide et économique — facturé à la moitié des points.

Votre clé d'API peut utiliser les quatre. Voir Modèles de voix pour les détails.

Consultez la Référence de l'API pour tous les détails.

Facturation

Les générations via l'API dépensent les mêmes points que l'application web — 1 point = 1 seconde d'audio. L'API facture sur la base de 15 caractères par seconde (un peu plus que les 17 de l'application web). Vous ne pouvez jamais dépenser plus que votre solde ; les requêtes sans points restants renvoient un 402.

Utilisez-la au sein des outils d'IA

Vous préférez Claude, Cursor ou un autre assistant d'IA ? Le serveur MCP expose les mêmes capacités sous forme d'outils natifs — rien à installer avec l'option hébergée.