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

Disponible dans tous les forfaits, y compris le forfait gratuit. Chaque appel consomme les points de votre compte (1 point pour 15 caractères). Créez une clé dans le Studio sous API & MCP dans la barre latérale (ou sur la page Développeur de vocallab.ai). (Licences à vie AppSumo : accès complet à partir du Tier 3 ; les Tiers 1 et 2 ont un accès limité, avec un débit de requêtes plus faible et des requêtes plus courtes.)

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 dans le Studio sous API & MCP (ou 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 / Studio Flash / 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-studio) :

• v-studio — VocalLab Studio : le plus récent, orientable (suit les instructions d'expression), plus de 200 langues. Le modèle par défaut.
• 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.
• 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.