> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# 配音为多种语言

> **Note**
>
> **操作指南** · 假设你已创建配音项目，如[配音 快速入门](/docs/zh/eleven-api/guides/cookbooks/dubbing)所示。

单个项目包含一份源转录文本，你可以按需添加任意数量的语言目标。每种语言独立生成，各自拥有状态和输出，因此只需翻译一次源文本，即可生成所有配音。

## 添加多种语言

为每种要配音的语言添加一个语言目标。每个目标初始状态均为 `queued`，并会在项目状态为 `ready` 后开始生成。

```python
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
]
```

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";
import "dotenv/config";

const elevenlabs = new ElevenLabsClient();

const projectId = "proj_1601kwkyxp0hfzvtmyxwqxx6mcy3";
const targetLanguages = ["es", "fr", "de", "ja"];

const languages = await Promise.all(
  targetLanguages.map((lang) =>
    elevenlabs.dubbing.project.language.create(projectId, { targetLanguage: lang })
  )
);
```

还可以在创建项目时通过向 `project.create` 传入 `target_language` 来将第一种语言加入队列。按照上文所示，使用 `language.create` 添加后续语言。

语言使用 BCP-47 标签指定，例如 `es` 或 `fr-CA`。有关所有可接受值，请参阅[支持的语言和方言](/docs/zh/overview/capabilities/dubbing#supported-languages)。

## 独立跟踪每种语言

语言会并行生成，并在不同时间完成。请列出项目的语言以查看每种语言的状态，而不是逐一轮询。

```python
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)
```

```typescript
while (true) {
  const result = await elevenlabs.dubbing.project.language.list(projectId);
  const pending = result.languages.filter(
    (l) => l.status === "queued" || l.status === "processing"
  );
  if (pending.length === 0) break;
  console.log(`${pending.length} language(s) still generating...`);
  await new Promise((resolve) => setTimeout(resolve, 5000));
}
```

## 下载所有已完成的配音

语言状态变为 `completed` 后，`outputs.lossless_audio` 会包含签名下载 URL。下载每个配音，同时跳过生成失败的语言。

```python
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")
```

```typescript
import { writeFile } from "fs/promises";

const result = await elevenlabs.dubbing.project.language.list(projectId);
for (const language of result.languages) {
  if (language.status !== "completed") {
    console.log(`Skipping ${language.targetLanguage}: ${language.status}`);
    continue;
  }
  const response = await fetch(language.outputs!.losslessAudio!);
  const buffer = Buffer.from(await response.arrayBuffer());
  await writeFile(`dubbed_${language.targetLanguage}.wav`, buffer);
  console.log(`Saved dubbed_${language.targetLanguage}.wav`);
}
```

签名 URL 在签发约 1 小时后过期。如果因 URL 过期导致下载失败，请再次使用 `language.get` 获取该语言，以取得新的 URL。

> **Tip**
>
> 如果某种语言生成失败，请在同一项目中使用 `language.create` 再次添加该语言，
> 而不是创建新项目。项目及其转录文本可重复使用，因此只会重新生成失败的
> 语言。