创建配音项目
通过上传的文件（file）或源 URL（source_url）创建配音项目。
项目记录创建后会立即返回，此时尚未获取源文件：项目初始状态为 queued，源文件转录完成后变为 ready。可为每种所需语言添加语言目标，或通过 target_language 在此处将第一个目标加入队列。
创建项目至少会按 1 种语言计费：项目创建时，即使尚未产生任何输出，也会收取至少 1 种语言的配音费用。此费用预付第一个语言目标——你添加的第一个目标或通过 target_language 加入队列的目标会使用这笔费用——每增加一种语言将单独计费。
处理较长源文件可能需要数分钟，建议传入 webhook_ids，以便在项目变为 ready 或 failed 时收到通知，而不是轮询查询。
请求头
请求
要配音的源媒体文件：最大为 3 GiB 的音频或视频文件。提供此项或 source_url，不能同时提供。
服务器端获取源媒体的公开 HTTP(S) URL，受与上传相同的大小和格式限制。提供此项或 file，不可同时提供。
可选的自由格式字符串（最多 500 个字符），用于在你的系统中标识项目。将原样存储并返回，不影响配音。
BCP-47 language tag of the source media; must be a language the transcription model supports. Any region or script subtag is ignored, since transcription is per-language. Omit to auto-detect.
此项目的每个语言目标所使用的配音模型（dubbing_v1 或 dubbing_v2）。默认为 dubbing_v2。在创建时固定——源内容会为该模型准备，因此之后项目和各个目标均无法更改。
用于偏向转录和翻译结果的关键词（例如产品或品牌名称）。最多 1,000 个词条；每个词条最多 50 个字符和 5 个单词；不允许使用字符 <>{}[]\。词条会去除首尾空格并去重。每个词条重复传递一次该字段，或传递单个 JSON 数组。
项目推进过程中要通知的工作区 webhook ID——这是轮询的替代方案，也是我们推荐的方式。每个 webhook 都会接收项目的 dubbing_project_ready 或 dubbing_project_failed 事件，以及其下每种语言的 dubbing_language_completed 或 dubbing_language_failed 事件；dubbing_language_completed 会携带输出下载 URL。最多 3 个 ID，且每个都必须已在工作区中配置——请参阅 Webhooks，了解如何创建 webhook 并验证其签名。每个 ID 重复传入一次该字段，或传入单个 JSON 数组或逗号分隔字符串。投递采用尽力而为机制，且可能重复，因此建议以幂等方式处理事件。
可选快捷方式：同时创建此 BCP-47 语言的语言目标，并在项目就绪后排队启动——等同于先创建项目，再创建一个语言目标。必须是配音模型支持的语言之一；带地区标识的标签必须是支持的方言之一。这是第一个语言目标，因此会计入项目最低收费，而非额外收费。其 ID 将在 language_ids 中返回。
仅限企业版。可选的 JSON 转录文本，可替代对源媒体的转录：一个 {"segments": [...]} 文档，最多包含 20,000 个片段，大小不超过 4 MiB。有关片段字段及其限制，请参阅 自带转录文本。提供转录文本时，必须指定 source_language。如果任意片段包含 translation，则必须指定 target_language，且每个片段都必须包含翻译；这些翻译将作为通过 target_language 创建的目标初始内容，随后跳过机器翻译。
响应
成功响应
配音项目的唯一标识符。
项目生命周期状态：源文件被提取前为 queued，转录期间为 preparing，转录完成且语言目标可开始处理后为 ready，或为 failed。项目不会显示为 processing，该值属于语言目标。
每次编辑源转录文本（添加、编辑或删除片段）时递增的单调计数器。
创建项目的时间。
项目上次更新的时间。
创建项目时作为 reference 提供的自由格式字符串；若未提供，则为 null。
BCP-47 language tag of the source media (null if auto-detected).
此项目每个语言目标使用的配音模型。在创建时固定，不能按语言选择。
源媒体元数据。在获取并解码源媒体后填充（创建后不久、项目处于 ready 前）；在此之前为 null。
此项目下目标语言的标识符。获取单个项目时会填充；创建项目时，若 target_language 创建了目标语言，也会填充。在列表响应中始终为空——请改为列出项目的目标语言。
当此项目及其语言达到 ready、completed 或 failed 状态时要通知的工作区 webhook ID。
项目失败原因；除非 status 为 failed，否则为 null。对于在引入失败报告前失败的少数项目，此字段也为 null。
准备源内容时出现的非致命情况；没有时为空。反映最新一次准备。为特定语言配音时出现的情况会在该语言中报告。