Tutoriais

Guia rápido de Dublagem

Aprenda a dublar arquivos de áudio e vídeo em outros idiomas usando a API de Dublagem.

Este guia mostra como dublar um arquivo de mídia para outro idioma com a API de Dublagem. Neste exemplo, você cria um projeto de dublagem a partir de um arquivo de áudio em inglês e gera uma dublagem em espanhol.

Um projeto de dublagem tem duas partes: um projeto, que contém uma mídia de origem e sua transcrição, e um ou mais idiomas de destino, cada um produzindo uma saída dublada em um único idioma. Você cria um projeto, espera a transcrição da origem, adiciona um idioma e baixa a dublagem finalizada.

A criação de um projeto cobra antecipadamente por um idioma — a cobrança mínima de um projeto de dublagem. Isso paga antecipadamente seu primeiro idioma de destino: o primeiro idioma adicionado o consome, e cada idioma adicional é cobrado separadamente. Consulte Quanto custa a Dublagem? para saber mais.

Os idiomas são especificados como tags BCP-47, por exemplo, es ou fr-CA. Consulte os idiomas e dialetos compatíveis para ver todos os valores aceitos.

Usar a API de Dublagem

1

Criar uma chave de API

Crie uma chave de API no painel aqui, que você usará para acessar a API com segurança.

Armazene a chave como um segredo gerenciado e passe-a aos SDKs como uma variável de ambiente por meio de um arquivo .env ou diretamente na configuração do seu app, conforme sua preferência.

.env
ELEVENLABS_API_KEY=<your_api_key_here>
2

Instalar o SDK

Também usaremos a biblioteca dotenv para carregar nossa chave de API de uma variável de ambiente.

pip install elevenlabs
pip install python-dotenv

O exemplo em Python usa a biblioteca requests para baixar o áudio dublado. Instale-a com pip install requests.

3

Fazer a solicitação à API

Crie um novo arquivo chamado example.py ou example.mts, dependendo da linguagem escolhida, e adicione o código a seguir:

# 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")

A URL de download em outputs.lossless_audio é assinada e expira cerca de uma hora após ser emitida. Busque o idioma novamente para obter uma URL nova caso ela tenha expirado.

Em seguida, execute-o:

python example.py

O áudio dublado é salvo em dubbed.wav no seu diretório de trabalho.

Lidar com falhas

Se adicionar um idioma não funcionar, adicione o mesmo idioma novamente ao projeto existente em vez de criar um novo projeto. O projeto e sua origem transcrita podem ser reutilizados, então tentar novamente o idioma é mais rápido e evita pagar a cobrança mínima de um idioma uma segunda vez.

Crie um novo projeto apenas se o próprio projeto atingir failed durante a preparação, o que significa que sua origem não pôde ser transcrita. Verifique o arquivo ou URL de origem e crie um novo projeto.

Workspaces Enterprise podem revisar e corrigir a transcrição de origem antes de adicionar um idioma, o que gera traduções mais precisas. Consulte Refinar e gerar novamente uma dublagem.

Próximas etapas

Usar sua própria transcrição

Crie um projeto a partir de uma transcrição existente e forneça suas próprias traduções

Refinar e gerar novamente uma dublagem

Edite a transcrição e as traduções de origem e gere novamente a dublagem

Dublar em vários idiomas

Adicione vários idiomas de destino a um único projeto

Referência da API

Explore todos os parâmetros e formatos de resposta da API de Dublagem