Hoppa till navigering
Handledningar

Snabbstart för dubbning

Lär dig hur du dubbar ljud- och videofiler mellan språk med Dubbing API.

Den här guiden visar hur du dubbar en mediefil till ett annat språk med Dubbing API. I det här exemplet skapar du ett dubbningsprojekt från en engelsk ljudfil och genererar en spansk dubbning.

Ett dubbningsprojekt har två delar: ett projekt, som innehåller en mediekälla och dess transkript, samt ett eller flera språkmål, där vart och ett skapar dubbad utdata på ett enda språk. Du skapar ett projekt, väntar på att källan transkriberas, lägger till ett språk och laddar sedan ned den färdiga dubbningen.

Att skapa ett projekt debiterar dig för ett språk i förväg — minimidebiteringen för ett dubbningsprojekt. Detta förbetalar ditt första språkmål: det första språket du lägger till använder det, och varje ytterligare språk debiteras separat. Se Vad kostar dubbning? för mer information.

Språk anges som BCP-47-taggar, till exempel es eller fr-CA. Se språk och dialekter som stöds för alla godkända värden.

Använda Dubbing API

1

Skapa en API-nyckel

Skapa en API-nyckel i dashboarden här, som du använder för att säkert få åtkomst till API:t.

Spara nyckeln som en hanterad hemlighet och skicka den till SDK:erna antingen som en miljövariabel via en .env-fil eller direkt i appens konfiguration, beroende på vad du föredrar.

.env
ELEVENLABS_API_KEY=<your_api_key_here>
2

Installera SDK:t

Vi använder också biblioteket dotenv för att läsa in vår API-nyckel från en miljövariabel.

pip install elevenlabs
pip install python-dotenv

Python-exemplet använder biblioteket requests för att ladda ned det dubbade ljudet. Installera det med pip install requests.

3

Gör API-begäran

Skapa en ny fil med namnet example.py eller example.mts, beroende på vilket språk du väljer, och lägg till följande kod:

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

Nedladdnings-URL:en i outputs.lossless_audio är signerad och upphör att gälla ungefär en timme efter att den har utfärdats. Hämta språket igen för att få en ny URL om den har gått ut.

Kör sedan programmet:

python example.py

Det dubbade ljudet sparas som dubbed.wav i din arbetskatalog.

Hantera fel

Om det inte går att lägga till ett språk lägger du till samma språk i det befintliga projektet igen, i stället för att skapa ett nytt projekt. Projektet och dess transkriberade källa kan återanvändas, så att försöka igen med språket går snabbare och gör att du slipper betala minimidebiteringen för ett språk en andra gång.

Skapa bara ett nytt projekt om projektet självt når failed under förberedelsen, vilket innebär att dess källa inte kunde transkriberas. Kontrollera källfilen eller URL:en och skapa sedan ett nytt projekt.

Företagsarbetsytor kan granska och korrigera källtranskriptet innan de lägger till ett språk, vilket ger mer korrekta översättningar. Se Förfina och generera om en dubbning.

Nästa steg

Använd ditt eget transkript

Skapa ett projekt från ett befintligt transkript och använd dina egna översättningar

Förfina och generera om en dubbning

Redigera källtranskriptet och översättningarna och generera sedan om dubbningen

Dubba till flera språk

Lägg till flera målspråk i ett enda projekt

API-referens

Utforska alla parametrar och svarsformat för Dubbing API