여러 언어로 더빙 | ElevenLabs Documentation

방법 가이드 · 더빙 빠른 시작에 설명된 대로 더빙 프로젝트를 만들었다고 가정합니다.

하나의 프로젝트에는 하나의 소스 트랜스크립트가 포함되며, 필요한 만큼 언어 대상을 추가할 수 있습니다. 각 언어는 독립적으로 생성되고 각자의 상태와 출력을 가지므로, 소스를 한 번 번역하여 모든 더빙을 만들 수 있습니다.

여러 언어 추가

더빙할 언어마다 하나의 언어 대상을 추가하세요. 각 대상은 queued 상태로 시작하며 프로젝트가 ready가 되면 생성이 시작됩니다.

import os
from dotenv import load_dotenv
from elevenlabs.client import ElevenLabs
load_dotenv()
elevenlabs = ElevenLabs(api_key=os.getenv("ELEVENLABS_API_KEY"))
project_id = "proj_1601kwkyxp0hfzvtmyxwqxx6mcy3"
target_languages = ["es", "fr", "de", "ja"]
languages = [
    elevenlabs.dubbing.project.language.create(project_id, target_language=lang)
    for lang in target_languages
]

project.create에 target_language를 전달하면 프로젝트를 생성할 때 첫 번째 언어도 대기열에 추가할 수 있습니다. 위에 나온 것처럼 language.create로 추가 언어를 더하세요.

언어는 es 또는 fr-CA와 같은 BCP-47 태그로 지정합니다. 허용되는 모든 값은 지원 언어 및 방언에서 확인하세요.

각 언어를 독립적으로 추적

언어는 병렬로 생성되며 완료 시점도 서로 다릅니다. 하나씩 폴링하는 대신 프로젝트의 언어 목록을 조회하여 각 언어의 상태를 확인하세요.

import time
while True:
    result = elevenlabs.dubbing.project.language.list(project_id)
    pending = [l for l in result.languages if l.status in ("queued", "processing")]
    if not pending:
        break
    print(f"{len(pending)} language(s) still generating...")
    time.sleep(5)

완료된 모든 더빙 다운로드

언어가 completed 상태가 되면 outputs.lossless_audio에 서명된 다운로드 URL이 포함됩니다. 실패한 언어는 건너뛰고 각각 다운로드하세요.

import requests
result = elevenlabs.dubbing.project.language.list(project_id)
for language in result.languages:
    if language.status != "completed":
        print(f"Skipping {language.target_language}: {language.status}")
        continue
    audio = requests.get(language.outputs.lossless_audio)
    with open(f"dubbed_{language.target_language}.wav", "wb") as f:
        f.write(audio.content)
    print(f"Saved dubbed_{language.target_language}.wav")

서명된 URL은 발급 후 약 1시간이 지나면 만료됩니다. URL이 만료되어 다운로드에 실패하면 language.get으로 언어를 다시 가져와 새 URL을 받으세요.

언어 생성에 실패하면 새 프로젝트를 만드는 대신 동일한 프로젝트에서 language.create로 해당 언어를 다시 추가하세요. 프로젝트와 트랜스크립트는 재사용할 수 있으므로 실패한 언어만 재생성됩니다.