Introduction
Resemble AI permet de créer des voix synthétiques réalistes à partir de quelques minutes d'enregistrement. En 2026, l'outil est devenu incontournable pour les projets de podcasts, de formation et d'assistants vocaux. Ce tutoriel vous accompagne depuis la création du compte jusqu'à l'intégration de l'API dans une application Node.js. Vous apprendrez à cloner une voix, à générer du texte en parole et à gérer les erreurs courantes. Aucune connaissance avancée en IA n'est requise.
Prérequis
- Node.js 20 ou supérieur
- Compte Resemble AI (gratuit pour démarrer)
- Connaissances basiques de JavaScript/TypeScript
- Un microphone pour enregistrer 5 minutes de voix
Installation du SDK
npm init -y
npm install @resemble/node dotenvNous initialisons le projet et installons le SDK officiel Resemble ainsi que dotenv pour gérer les clés API en sécurité.
Configuration des variables d'environnement
RESEMBLE_API_KEY=votre_cle_api_ici
RESEMBLE_PROJECT_UUID=votre_uuid_projetCréez un fichier .env à la racine. Ne jamais commiter ce fichier. La clé est obtenue depuis le dashboard Resemble.
Initialisation du client Resemble
import { Resemble } from '@resemble/node';
import 'dotenv/config';
const client = Resemble.client({
apiKey: process.env.RESEMBLE_API_KEY!,
});Ce code initialise le client avec votre clé API. Le point d'exclamation TypeScript indique que la variable est définie.
Cloner une voix
const voice = await client.voices.create({
name: 'Ma Voix Test',
description: 'Voix de démonstration 2026',
consent: 'https://exemple.com/consent.mp3'
});
console.log(voice.uuid);Cette requête crée une nouvelle voix clonée. Fournissez un fichier de consentement et 3-5 minutes d'audio clair pour de meilleurs résultats.
Générer du speech
const audio = await client.voices.generate({
voiceUuid: 'uuid-de-votre-voix',
body: 'Bonjour, ceci est un test Resemble AI en 2026.',
outputFormat: 'mp3'
});
console.log(audio.audio_src);Générez un fichier audio à partir de texte. Le résultat contient une URL temporaire valide 24h.
Bonnes pratiques
- Toujours stocker la clé API dans des variables d'environnement
- Limiter la longueur des textes à 3000 caractères par requête
- Utiliser des voix de haute qualité pour les projets clients
- Sauvegarder les UUID des voix dans votre base de données
- Tester la latence avec des phrases courtes avant déploiement
Erreurs courantes à éviter
- Oublier d'ajouter le consentement audio lors du clonage
- Dépasser le quota gratuit sans passer en plan payant
- Ignorer les erreurs 429 (rate limiting) sans retry
- Stocker la clé API directement dans le code source
Pour aller plus loin
Explorez les fonctionnalités avancées comme le streaming temps réel et les émotions. Découvrez nos formations Learni dédiées à l'IA vocale.