Maîtriser le doublage média

Doubler des vidéos et des fichiers audio d'une langue à une autre peut considérablement élargir votre audience. L'API ElevenLabs offre un moyen fluide d'automatiser ce processus, vous permettant de doubler des fichiers média avec une technologie de pointe. Dans ce guide, nous explorerons comment télécharger une vidéo ou un fichier audio, le doubler et télécharger la version traduite. De plus, nous verrons comment doubler du contenu directement depuis des plateformes comme YouTube, TikTok ou Twitter.

Pour commencer

Avant de commencer, assurez-vous d'avoir les prérequis suivants :

• Un compte ElevenLabs avec une clé API.
• Python ou Node.js installé sur votre machine.

Installez le SDK ElevenLabs en utilisant la commande suivante :

pip install elevenlabs

Gérez également vos variables d'environnement en installant :

pip install python-dotenv

Créez un fichier .env dans le répertoire de votre projet et ajoutez vos identifiants :

ELEVENLABS_API_KEY=votre_cle_api_elevenlabs_ici

Doubler un fichier

Pour doubler un fichier, envoyez-le au service de doublage ElevenLabs. Voici une fonction Python pour vous aider à démarrer :

def create_dub_from_file(input_file_path: str, file_format: str, source_language: str, target_language: str) -> Optional[str]:
    """
    Dubs an audio or video file from one language to another and saves the output.
    """
    if not os.path.isfile(input_file_path):
        raise FileNotFoundError(f"The input file does not exist: {input_file_path}")
    with open(input_file_path, "rb") as audio_file:
        response = client.dubbing.dub_a_video_or_an_audio_file(
            file=(os.path.basename(input_file_path), audio_file, file_format),
            target_lang=target_language,
            mode="automatic",
            source_lang=source_language,
            num_speakers=1,
            watermark=False,
        )
    dubbing_id = response.dubbing_id
    if wait_for_dubbing_completion(dubbing_id):
        output_file_path = download_dubbed_file(dubbing_id, target_language)
        return output_file_path
    else:
        return None

Surveillance de la progression

Utilisez la fonction wait_for_dubbing_completion() pour vérifier l'état de votre processus de doublage. Cette fonction interrogera l'API et vous notifiera une fois le doublage terminé.

Enregistrement du fichier doublé

Une fois le doublage terminé, enregistrez le fichier doublé localement en utilisant la fonction download_dubbed_file(). Le fichier sera stocké dans un répertoire structuré comme data/{dubbing_id}/{language_code}.mp4.

Doublage depuis des URLs

Pour le contenu web, vous pouvez doubler directement depuis une URL. Cela prend en charge des plateformes comme YouTube, TikTok, Twitter et Vimeo. Voici comment procéder :

def create_dub_from_url(source_url: str, source_language: str, target_language: str) -> Optional[str]:
    """
    Downloads a video from a URL, and creates a dubbed version in the target language.
    """
    response = client.dubbing.dub_a_video_or_an_audio_file(
        source_url=source_url,
        target_lang=target_language,
        mode="automatic",
        source_lang=source_language,
        num_speakers=1,
        watermark=True,
    )
    dubbing_id = response.dubbing_id
    if wait_for_dubbing_completion(dubbing_id):
        output_file_path = download_dubbed_file(dubbing_id, target_language)
        return output_file_path
    else:
        return None

Conclusion

Avec ce guide, vous avez maintenant une configuration de base pour doubler du contenu audio et vidéo en utilisant l'API ElevenLabs. Que vous travailliez avec des fichiers locaux ou du contenu en ligne, vous pouvez créer des versions multilingues de vos médias pour répondre à des audiences diverses. Suivez toujours les meilleures pratiques lors de la manipulation des clés API et des données sensibles, et consultez la documentation de l'API ElevenLabs pour des fonctionnalités plus avancées.

Référence : Documentation API ElevenLabs par ElevenLabs.