ElevenAPIDubbingLanguage targets

创建配音目标语言

添加项目配音目标语言，并将配音任务加入队列。 此调用会生成配音音频，并按次计费。目标创建后状态为 `queued`，项目达到 `ready` 状态后便会开始处理，因此可在项目创建后的任何时间添加。它会继承项目的配音模型，无法选择其他模型。 使用 `webhook_ids` 创建的项目会发送包含输出下载 URL 的 `dubbing_language_completed` 事件，因此建议订阅该事件，而非轮询此目标直至完成。

路径参数

project_idstring必需

父配音项目标识符。

请求头

xi-api-keystring可选

请求

This endpoint expects an object.
target_languagestring必需

BCP-47 language tag to dub the project into (for example, fr or es-MX). Must be one of the languages the project’s dubbing model supports, and a region-qualified tag must be one of the supported dialects.

voice_settingsobject or null可选

应用于该语言中每位说话者的音色设置。省略则使用默认设置。

translationsmap from strings to strings or null可选

仅限企业版。可选翻译，可替代机器翻译。将每个源片段的 external_id（如果未提供，则使用其 id）映射到译文；每个源片段必须且只能覆盖一次。最多 20,000 个条目，文本总量不超过 4 MiB。请参阅 自带转录文本。

响应

成功响应

language_idstring

目标语言的唯一标识符。

project_idstring

父配音项目标识符。

target_languagestring

BCP-47 language tag this target is dubbed into.

statusenum

生命周期状态：queued（等待项目就绪或等待工作线程）、配音期间为 processing、输出可用后为 completed、输出生成后转录内容发生变更时为 stale，或为 failed。

允许的值:
revisioninteger

每当此目标的转录文本发生变化时递增的单调计数器（影响它的源编辑，或对其翻译的编辑）。

created_atstring格式: "date-time"

创建语言目标的时间。

updated_atstring格式: "date-time"

语言目标上次更新的时间。

model_idstring or null可选

此目标使用的配音模型，从项目继承，不能按语言选择。

voice_settingsobject or null可选

应用于该语言中每位说话者的音色设置；使用默认设置时为 null。

outputsobject or null可选

已签名的输出 URL；在目标生成输出前为 null（completed 后会提供，并在 stale 时保留——比较 output_revision 和 revision 可判断输出是否为最新）。

output_revisioninteger or null可选

当前配音输出生成时所基于的 revision；最新时等于 revision，stale 时则小于它。在生成完成前，此值为 null。

errorobject or null可选

此语言失败的原因；除非 status 为 failed，否则为 null；对于在引入失败报告前失败的少数语言，此字段也为 null。代码 project_failed 表示父项目失败，请查看该项目以了解根本原因。

warningslist of objects可选

为此语言配音时出现的非致命情况；没有时为空。反映最新一次生成。准备源内容时出现的情况会在项目中报告。

错误

422
Unprocessable Entity Error