Tutoriels

Démarrage rapide du doublage

Découvrez comment doubler des fichiers audio et vidéo dans différentes langues avec l’API de doublage.

Ce guide vous montre comment doubler un fichier multimédia dans une autre langue avec l’API de doublage. Dans cet exemple, vous créez un projet de doublage à partir d’un fichier audio en anglais et générez un doublage en espagnol.

Un projet de doublage comporte deux éléments : un projet, qui contient un média source et sa transcription, et une ou plusieurs cibles de langue, chacune produisant un résultat doublé dans une seule langue. Vous créez un projet, attendez que sa source soit transcrite, ajoutez une langue, puis téléchargez le doublage terminé.

La création d’un projet vous facture d’emblée une langue, soit le coût minimum d’un projet de doublage. Cela prépaye votre première cible de langue : la première langue ajoutée l’utilise, et chaque langue supplémentaire est facturée séparément. Consultez Combien coûte le doublage ? pour plus de détails.

Les langues sont indiquées sous forme de balises BCP-47, par exemple es ou fr-CA. Consultez les langues et dialectes pris en charge pour connaître toutes les valeurs acceptées.

Utiliser l’API de doublage

1

Créer une clé API

Créez une clé API dans le Dashboard ici, que vous utiliserez pour accéder à l’API de manière sécurisée.

Stockez la clé comme secret géré et transmettez-la aux SDK soit en tant que variable d’environnement via un fichier .env, soit directement dans la configuration de votre application, selon vos préférences.

.env
ELEVENLABS_API_KEY=<your_api_key_here>
2

Installer le SDK

Nous utiliserons également la bibliothèque dotenv pour charger notre clé API depuis une variable d’environnement.

pip install elevenlabs
pip install python-dotenv

L’exemple Python utilise la bibliothèque requests pour télécharger l’audio doublé. Installez-la avec pip install requests.

3

Effectuer la requête API

Créez un nouveau fichier nommé example.py ou example.mts, selon le langage choisi, et ajoutez le code suivant :

# example.py
import os
import time
import requests
from dotenv import load_dotenv
from elevenlabs.client import ElevenLabs
load_dotenv()
elevenlabs = ElevenLabs(
    api_key=os.getenv("ELEVENLABS_API_KEY"),
)
# 1. Create a project from a source URL
project = elevenlabs.dubbing.project.create(
    source_url="https://storage.googleapis.com/eleven-public-cdn/audio/marketing/nicole.mp3",
    source_language="en",
    reference="Quickstart dub",
)
# 2. Wait for the source media to be transcribed
while True:
    project = elevenlabs.dubbing.project.get(project.project_id)
    if project.status == "ready":
        break
    if project.status == "failed":
        raise RuntimeError("Project preparation failed")
    print("Preparing project...")
    time.sleep(5)
# 3. Add a Spanish language target
language = elevenlabs.dubbing.project.language.create(
    project.project_id,
    target_language="es",
)
# 4. Wait for the dub to finish generating
while True:
    language = elevenlabs.dubbing.project.language.get(
        project.project_id, language.language_id
    )
    if language.status == "completed":
        break
    if language.status == "failed":
        raise RuntimeError("Dub generation failed")
    print("Generating dub...")
    time.sleep(5)
# 5. Download the dubbed audio from the signed URL
audio = requests.get(language.outputs.lossless_audio)
with open("dubbed.wav", "wb") as f:
    f.write(audio.content)
print("Saved dubbed audio to dubbed.wav")

L’URL de téléchargement dans outputs.lossless_audio est signée et expire environ une heure après son émission. Récupérez de nouveau la langue pour obtenir une nouvelle URL si elle a expiré.

Exécutez-le ensuite :

python example.py

L’audio doublé est enregistré sous le nom dubbed.wav dans votre répertoire de travail.

Gérer les échecs

Si l’ajout d’une langue échoue, ajoutez à nouveau la même langue au projet existant plutôt que de créer un nouveau projet. Le projet et sa source transcrite sont réutilisables ; réessayer la langue est donc plus rapide et vous évite de payer une deuxième fois le coût minimum d’une langue.

Créez un nouveau projet uniquement si le projet lui-même atteint l’état failed pendant la préparation, ce qui signifie que sa source n’a pas pu être transcrite. Vérifiez le fichier ou l’URL source, puis créez un nouveau projet.

Les Workspaces Enterprise peuvent réviser et corriger la transcription source avant d’ajouter une langue, ce qui produit des traductions plus précises. Consultez Affiner et régénérer un doublage.

Prochaines étapes

Utiliser votre propre transcription

Créez un projet à partir d’une transcription existante et fournissez vos propres traductions

Affiner et régénérer un doublage

Modifiez la transcription source et les traductions, puis régénérez le doublage

Doubler dans plusieurs langues

Ajoutez plusieurs langues cibles à un même projet

Guide de l’API

Explorez tous les paramètres et formats de réponse de l’API de doublage