调用 `GetAITranslationProject` 接口获取 AI 翻译项目的详细信息，包括项目基本信息和附加信息（说话者信息、源语言对话文本和目标语言对话文本等）。 ## 注意事项 * 本接口的单用户 QPS 限制为 10 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见 [QPS 限制](https://www.volcengine.com/docs/4/1333456)。 ## 请求说明请求地址：**https://vod.volcengineapi.com?Action=GetAITranslationProject&Version=2025-01-01** ## 调试 ## 请求参数下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见[公共请求参数](https://www.volcengine.com/docs/4/4357#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0)。 ```mixin-react const columns = [ { "title": "参数", "dataIndex": "name", "headerCellStyle": { "minWidth": "170px" } }, { "title": "类型", "dataIndex": "type", "headerCellStyle": { "width": "140px" }, "render": (val) => }, { "title": "是否必选", "dataIndex": "required", "headerCellStyle": { "width": "100px" } }, { "title": "示例值", "dataIndex": "example", "headerCellStyle": { "width": "190px" }, "render": (val) => }, { "title": "描述", "dataIndex": "title", "headerCellStyle": { "width": "367px" }, "render": (val) => } ]; const data = [ { "name": "Action", "key": "Action", "title": "接口名称。当前 API 的名称为 GetAITranslationProject。", "example": "GetAITranslationProject", "required": "是", "type": "String" }, { "name": "Version", "key": "Version", "title": "接口版本。当前 API 的版本为 2025-01-01。", "example": "2025-01-01", "required": "是", "type": "String" }, { "name": "SpaceName", "key": "0-0", "title": "

点播空间名。您可通过以下方式获取空间名称：

在视频点播控制台空间管理页面查看当前账号下所有空间的名称。
调用 ListSpace 接口获取当前账号下所有空间的名称。

", "example": "test", "required": "是", "type": "String" }, { "name": "ProjectId", "key": "0-1", "title": "

项目 ID。您可通过以下方式获取项目 ID：

在 SubmitAITranslationWorkflow 接口的返回参数中获取。
配置 AI 翻译任务执行完成事件。

", "example": "684038d6b71***05b266fefe", "required": "是", "type": "String" }, { "name": "Additions", "key": "0-2", "title": "

指定需要返回的附加信息类型，多个类型用逗号分隔。不传此参数时仅返回项目基本信息。支持的附加信息类型如下：

Speakers：说话者信息
SourceUtterances：源语言文本
SourceTracks：源轨道信息
SourceClips：源片段信息
TargetUtterances：目标语言文本
TargetTracks：目标轨道信息
TargetClips：目标片段信息
BackgroundClip：背景片段信息

", "example": "Speakers,SourceUtterances,TargetClips", "required": "否", "type": "String" } ]; return (); ``` ## 返回参数下表仅列出本接口特有的返回参数。更多信息请见[公共返回参数](https://www.volcengine.com/docs/4/4357#%E5%85%AC%E5%85%B1%E8%BF%94%E5%9B%9E%E5%8F%82%E6%95%B0)。 ```mixin-react const columns = [ { "title": "参数", "dataIndex": "name", "headerCellStyle": { "minWidth": "261px" } }, { "title": "类型", "dataIndex": "type", "headerCellStyle": { "width": "170px" }, "render": (val) => }, { "title": "示例值", "dataIndex": "example", "headerCellStyle": { "width": "190px" }, "render": (val) => }, { "title": "描述", "dataIndex": "title", "headerCellStyle": { "width": "346px" }, "render": (val) => } ]; const data = [ { "name": "ProjectInfo", "key": "0-1-0", "title": "项目信息", "example": "-", "type": "Object", "children": [ { "name": "ProjectId", "key": "0-1-0-0", "title": "项目 ID", "example": "684038d6***c9005b266fefe", "type": "String" }, { "name": "ProjectVersion", "key": "0-1-0-1", "title": "项目版本", "example": "01c4fa5da***48a588a46f81e282b100", "type": "String" }, { "name": "WorkflowId", "key": "0-1-0-2", "title": "工作流 ID", "example": "684038d6***c9005b266fefd", "type": "String" }, { "name": "CreatedAt", "key": "0-1-0-3", "title": "项目创建时间，Unix 时间戳，精度为秒。", "example": "1749039318", "type": "String" }, { "name": "UpdatedAt", "key": "0-1-0-4", "title": "项目更新时间，Unix 时间戳，精度为秒。", "example": "1749039973", "type": "String" }, { "name": "Status", "key": "0-1-0-5", "title": "

项目状态，取值如下：

InProcessing：处理中
ProcessSuspended：处理暂停
ProcessSucceed：处理完成
ProcessFailed：处理失败
InExporting：导出中
ExportSucceed：导出完成
ExportFailed：导出失败

", "example": "ProcessSucceed", "type": "String" }, { "name": "InputVideoTitle", "key": "0-1-0-7", "title": "输入视频名称", "example": "example.mp4", "type": "String" }, { "name": "TranslationTypeList", "key": "0-1-0-8", "title": "

执行的翻译类型组合，支持以下选项：

["SubtitleTranslation"]：仅文本翻译。
["SubtitleTranslation","VoiceTranslation"]：文本和语音翻译。
["SubtitleTranslation","VoiceTranslation", "FacialTranslation"]：文本、语音和面容翻译。

说明

翻译类型详细介绍请见声影智译。

", "example": "["SubtitleTranslation","VoiceTranslation", "FacialTranslation"]", "type": "String[]", "children": [] }, { "name": "BackgroundAudio", "key": "0-1-0-10", "title": "背景音频信息", "example": "-", "type": "Object", "children": [ { "name": "IsAudio", "key": "0-1-0-10-0", "title": "是否为音频", "example": "true", "type": "Boolean" }, { "name": "Uri", "key": "0-1-0-10-1", "title": "文件存储路径", "example": "tos-vod-cn-v-f724fac40***19c6/example.mp4", "type": "String" }, { "name": "Vid", "key": "0-1-0-10-2", "title": "文件 Vid。仅在 InputVideo 和 OutputVideo 结构中此字段有值。", "example": "v0299fg***4d103gsqljht10tatbreg", "type": "String" }, { "name": "DurationSecond", "key": "0-1-0-10-3", "title": "文件时长，单位为秒", "example": "159.104", "type": "Double" }, { "name": "Url", "key": "0-1-0-10-4", "title": "文件访问 URL", "example": "https://example.volcvideo.com/example.mp4", "type": "String" }, { "name": "FileName", "key": "0-1-0-10-5", "title": "文件路径，可用于拼接访问地址。", "example": "video.mp4", "type": "String" } ] }, { "name": "ForegroundAudio", "key": "0-1-0-11", "title": "前景音频信息", "example": "-", "type": "Object", "children": [ { "name": "IsAudio", "key": "0-1-0-11-0", "title": "是否为音频", "example": "true", "type": "Boolean" }, { "name": "Uri", "key": "0-1-0-11-1", "title": "文件存储路径", "example": "tos-vod-cn-v-f724fac40***19c6/example.mp4", "type": "String" }, { "name": "Vid", "key": "0-1-0-11-2", "title": "文件 Vid。仅在 InputVideo 和 OutputVideo 结构中此字段有值。", "example": "v0299fg***4d103gsqljht10tatbreg", "type": "String" }, { "name": "DurationSecond", "key": "0-1-0-11-3", "title": "文件时长，单位为秒", "example": "159.104", "type": "Double" }, { "name": "Url", "key": "0-1-0-11-4", "title": "文件访问 URL", "example": "https://example.volcvideo.com/example.mp4", "type": "String" }, { "name": "FileName", "key": "0-1-0-11-5", "title": "文件路径，可用于拼接访问地址。", "example": "video.mp4", "type": "String" } ] }, { "name": "InputVideo", "key": "0-1-0-12", "title": "输入视频信息", "example": "-", "type": "Object", "children": [ { "name": "IsAudio", "key": "0-1-0-12-0", "title": "是否为音频", "example": "true", "type": "Boolean" }, { "name": "Uri", "key": "0-1-0-12-1", "title": "文件存储路径", "example": "tos-vod-cn-v-f724fac40***19c6/example.mp4", "type": "String" }, { "name": "Vid", "key": "0-1-0-12-2", "title": "文件 Vid。仅在 InputVideo 和 OutputVideo 结构中此字段有值。", "example": "v0299fg***4d103gsqljht10tatbreg", "type": "String" }, { "name": "DurationSecond", "key": "0-1-0-12-3", "title": "文件时长，单位为秒", "example": "159.104", "type": "Double" }, { "name": "Url", "key": "0-1-0-12-4", "title": "文件访问 URL", "example": "https://example.volcvideo.com/example.mp4", "type": "String" }, { "name": "FileName", "key": "0-1-0-12-5", "title": "文件路径，可用于拼接访问地址。", "example": "video.mp4", "type": "String" } ] }, { "name": "PreviewVideo", "key": "0-1-0-13", "title": "预览视频信息", "example": "-", "type": "Object", "children": [ { "name": "IsAudio", "key": "0-1-0-13-0", "title": "是否为音频", "example": "true", "type": "Boolean" }, { "name": "Uri", "key": "0-1-0-13-1", "title": "文件存储路径", "example": "tos-vod-cn-v-f724fac40***19c6/example.mp4", "type": "String" }, { "name": "Vid", "key": "0-1-0-13-2", "title": "文件 Vid。仅在 InputVideo 和 OutputVideo 结构中此字段有值。", "example": "v0299fg***4d103gsqljht10tatbreg", "type": "String" }, { "name": "DurationSecond", "key": "0-1-0-13-3", "title": "文件时长，单位为秒", "example": "159.104", "type": "Double" }, { "name": "Url", "key": "0-1-0-13-4", "title": "文件访问 URL", "example": "https://example.volcvideo.com/example.mp4", "type": "String" }, { "name": "FileName", "key": "0-1-0-13-5", "title": "文件路径，可用于拼接访问地址。", "example": "video.mp4", "type": "String" } ] }, { "name": "PreviewVideoMuted", "key": "0-1-0-14", "title": "预览视频无音频", "example": "-", "type": "Object", "children": [ { "name": "IsAudio", "key": "0-1-0-14-0", "title": "是否为音频", "example": "true", "type": "Boolean" }, { "name": "Uri", "key": "0-1-0-14-1", "title": "文件存储路径", "example": "tos-vod-cn-v-f724fac40***19c6/example.mp4", "type": "String" }, { "name": "Vid", "key": "0-1-0-14-2", "title": "文件 Vid。仅在 InputVideo 和 OutputVideo 结构中此字段有值。", "example": "v0299fg***4d103gsqljht10tatbreg", "type": "String" }, { "name": "DurationSecond", "key": "0-1-0-14-3", "title": "文件时长，单位为秒", "example": "159.104", "type": "Double" }, { "name": "Url", "key": "0-1-0-14-4", "title": "文件访问 URL", "example": "https://example.volcvideo.com/example.mp4", "type": "String" }, { "name": "FileName", "key": "0-1-0-14-5", "title": "文件路径，可用于拼接访问地址。", "example": "video.mp4", "type": "String" } ] }, { "name": "OutputVideo", "key": "0-1-0-15", "title": "输出视频信息", "example": "-", "type": "Object", "children": [ { "name": "IsAudio", "key": "0-1-0-15-0", "title": "是否为音频", "example": "true", "type": "Boolean" }, { "name": "Uri", "key": "0-1-0-15-1", "title": "文件存储路径", "example": "tos-vod-cn-v-f724fac40***19c6/example.mp4", "type": "String" }, { "name": "Vid", "key": "0-1-0-15-2", "title": "文件 Vid。仅在 InputVideo 和 OutputVideo 结构中此字段有值。", "example": "v0299fg***4d103gsqljht10tatbreg", "type": "String" }, { "name": "DurationSecond", "key": "0-1-0-15-3", "title": "文件时长，单位为秒", "example": "159.104", "type": "Double" }, { "name": "Url", "key": "0-1-0-15-4", "title": "文件访问 URL", "example": "https://example.volcvideo.com/example.mp4", "type": "String" }, { "name": "FileName", "key": "0-1-0-15-5", "title": "文件路径，可用于拼接访问地址。", "example": "video.mp4", "type": "String" } ] }, { "name": "VoiceTranslationVideo", "key": "0-1-0-16", "title": "语音翻译视频", "example": "-", "type": "Object", "children": [ { "name": "IsAudio", "key": "0-1-0-16-0", "title": "是否为音频", "example": "true", "type": "Boolean" }, { "name": "Uri", "key": "0-1-0-16-1", "title": "文件存储路径", "example": "tos-vod-cn-v-f724fac40***19c6/example.mp4", "type": "String" }, { "name": "Vid", "key": "0-1-0-16-2", "title": "文件 Vid。仅在 InputVideo 和 OutputVideo 结构中此字段有值。", "example": "v0299fg***4d103gsqljht10tatbreg", "type": "String" }, { "name": "DurationSecond", "key": "0-1-0-16-3", "title": "文件时长，单位为秒", "example": "159.104", "type": "Double" }, { "name": "Url", "key": "0-1-0-16-4", "title": "文件访问 URL", "example": "https://example.volcvideo.com/example.mp4", "type": "String" }, { "name": "FileName", "key": "0-1-0-16-5", "title": "文件路径，可用于拼接访问地址。", "example": "video.mp4", "type": "String" } ] }, { "name": "FacialTranslationVideo", "key": "0-1-0-17", "title": "面容翻译视频", "example": "-", "type": "Object", "children": [ { "name": "IsAudio", "key": "0-1-0-17-0", "title": "是否为音频", "example": "true", "type": "Boolean" }, { "name": "Uri", "key": "0-1-0-17-1", "title": "文件存储路径", "example": "tos-vod-cn-v-f724fac40***19c6/example.mp4", "type": "String" }, { "name": "Vid", "key": "0-1-0-17-2", "title": "文件 Vid。仅在 InputVideo 和 OutputVideo 结构中此字段有值。", "example": "v0299fg***4d103gsqljht10tatbreg", "type": "String" }, { "name": "DurationSecond", "key": "0-1-0-17-3", "title": "文件时长，单位为秒", "example": "159.104", "type": "Double" }, { "name": "Url", "key": "0-1-0-17-4", "title": "文件访问 URL", "example": "https://example.volcvideo.com/example.mp4", "type": "String" }, { "name": "FileName", "key": "0-1-0-17-5", "title": "文件路径，可用于拼接访问地址。", "example": "video.mp4", "type": "String" } ] }, { "name": "Speakers", "key": "0-1-0-18", "title": "说话人信息，仅当请求参数 Additions 中包含 Speakers时返回。", "example": "-", "type": "Object[]", "children": [ { "name": "Id", "key": "0-1-0-18-0", "title": "说话人 ID", "example": "68403b65e***4cc4835c80f4", "type": "String" }, { "name": "Name", "key": "0-1-0-18-1", "title": "说话人名称", "example": "Speaker 1", "type": "String" }, { "name": "Voice", "key": "0-1-0-18-2", "title": "说话人初始音色", "example": "zh_female_***_bigtts", "type": "String" }, { "name": "ProjectId", "key": "0-1-0-18-3", "title": "项目 ID", "example": "684038d***1c9005b266fefe", "type": "String" }, { "name": "CurrentVoice", "key": "0-1-0-18-4", "title": "说话人当前音色", "example": "zh_male_***_bigtts", "type": "String" } ] }, { "name": "SourceUtterances", "key": "0-1-0-19", "title": "源语言句段信息。仅当请求参数 Additions 中包含 SourceUtterances时返回。", "example": "-", "type": "Object[]", "children": [ { "name": "Id", "key": "0-1-0-19-0", "title": "句段 ID", "example": "68403b65***64cc4835c8141", "type": "String" }, { "name": "SpeakerId", "key": "0-1-0-19-1", "title": "说话人 ID", "example": "68403b65***64cc4835c80f4", "type": "String" }, { "name": "BlueprintId", "key": "0-1-0-19-2", "title": "蓝图 ID", "example": "684038d6***c9005b266feff", "type": "String" }, { "name": "ClipId", "key": "0-1-0-19-3", "title": "片段 ID", "example": "68403b65***64cc4835c8104", "type": "String" }, { "name": "Text", "key": "0-1-0-19-4", "title": "文本内容", "example": "文本内容", "type": "String" }, { "name": "ProjectId", "key": "0-1-0-19-5", "title": "项目 ID", "example": "684038d6***c9005b266fefe", "type": "String" }, { "name": "IsFacialTranslation", "key": "0-1-0-19-6", "title": "是否为面容翻译", "example": "false", "type": "Boolean" }, { "name": "TranslationType", "key": "0-1-0-19-7", "title": "

文本翻译类别，取值如下：

source：源语言
target：目标语言

", "example": "source", "type": "String" }, { "name": "Status", "key": "0-1-0-19-8", "title": "

文本状态，取值如下：

online: 线上
need_update: 需要更新

", "example": "online", "type": "String" }, { "name": "SourceId", "key": "0-1-0-19-9", "title": "源语言句段 ID。仅当 TranslationType 为 target 时生效，用于提示该目标语言句段所对应的源语言句段。", "example": "68d144a***e8202f52f29b0", "type": "String" } ] }, { "name": "TargetUtterances", "key": "0-1-0-20", "title": "目标语言句段信息。仅当请求参数 Additions 中包含 TargetUtterances时返回。", "example": "-", "type": "Object[]", "children": [ { "name": "Id", "key": "0-1-0-20-0", "title": "句段 ID", "example": "68403b65***64cc4835c8141", "type": "String" }, { "name": "SpeakerId", "key": "0-1-0-20-1", "title": "说话人 ID", "example": "68403b65***64cc4835c80f4", "type": "String" }, { "name": "BlueprintId", "key": "0-1-0-20-2", "title": "蓝图 ID", "example": "684038d6***c9005b266feff", "type": "String" }, { "name": "ClipId", "key": "0-1-0-20-3", "title": "片段 ID", "example": "68403b65***64cc4835c8104", "type": "String" }, { "name": "Text", "key": "0-1-0-20-4", "title": "文本内容", "example": "文本内容", "type": "String" }, { "name": "ProjectId", "key": "0-1-0-20-5", "title": "项目 ID", "example": "684038d6***c9005b266fefe", "type": "String" }, { "name": "IsFacialTranslation", "key": "0-1-0-20-6", "title": "是否为面容翻译", "example": "false", "type": "Boolean" }, { "name": "TranslationType", "key": "0-1-0-20-7", "title": "

文本翻译类别，取值如下：

source：源语言
target：目标语言

", "example": "source", "type": "String" }, { "name": "Status", "key": "0-1-0-20-8", "title": "

文本状态，取值如下：

online: 线上
need_update: 需要更新

", "example": "online", "type": "String" }, { "name": "SourceId", "key": "0-1-0-20-9", "title": "源语言句段 ID。仅当 TranslationType 为 target 时生效，用于提示该目标语言句段所对应的源语言句段。", "example": "68d144a***e8202f52f29b0", "type": "String" } ] }, { "name": "SourceTracks", "key": "0-1-0-21", "title": "源轨道信息，仅当请求参数 Additions 中包含 SourceTracks时返回。", "example": "-", "type": "Object[]", "children": [ { "name": "Id", "key": "0-1-0-21-0", "title": "轨道 ID", "example": "68403b65ef364cc4835c80f9", "type": "String" }, { "name": "BlueprintId", "key": "0-1-0-21-1", "title": "蓝图 ID", "example": "684038d6b71c9005b266feff", "type": "String" }, { "name": "SpeakerId", "key": "0-1-0-21-2", "title": "说话者 ID", "example": "68403b65ef364cc4835c80f4", "type": "String" }, { "name": "TranslationType", "key": "0-1-0-21-3", "title": "

轨道翻译类型，取值如下：

source: 源语言
target: 目标语言

", "example": "source", "type": "String" } ] }, { "name": "TargetTracks", "key": "0-1-0-22", "title": "目标轨道信息，仅当请求参数 Additions 中包含 TargetTracks时返回。", "example": "-", "type": "Object[]", "children": [ { "name": "Id", "key": "0-1-0-22-0", "title": "轨道 ID", "example": "68403b65ef364cc4835c80f9", "type": "String" }, { "name": "BlueprintId", "key": "0-1-0-22-1", "title": "蓝图 ID", "example": "684038d6b71c9005b266feff", "type": "String" }, { "name": "SpeakerId", "key": "0-1-0-22-2", "title": "说话者 ID", "example": "68403b65ef364cc4835c80f4", "type": "String" }, { "name": "TranslationType", "key": "0-1-0-22-3", "title": "

轨道翻译类型，取值如下：

source: 源语言
target: 目标语言

", "example": "source", "type": "String" } ] }, { "name": "SourceBlueprints", "key": "0-1-0-23", "title": "源语言蓝图", "example": "-", "type": "Object[]", "children": [ { "name": "Id", "key": "0-1-0-23-0", "title": "蓝图 ID", "example": "684038d6b71c9005b266feff", "type": "String" }, { "name": "Language", "key": "0-1-0-23-1", "title": "

语言，取值如下：

en：英文
ja：日文
es：西班牙语
pt：葡萄牙语
zh：中文
id：印尼语

", "example": "zh", "type": "String" }, { "name": "ProjectId", "key": "0-1-0-23-2", "title": "项目 ID", "example": "684038d6b71c9005b266fefe", "type": "String" }, { "name": "TranslationType", "key": "0-1-0-23-3", "title": "

翻译类型，取值如下：

source：源语言
target：目标语言

", "example": "source", "type": "String" } ] }, { "name": "TargetBlueprints", "key": "0-1-0-24", "title": "目标语言蓝图", "example": "-", "type": "Object[]", "children": [ { "name": "Id", "key": "0-1-0-24-0", "title": "蓝图 ID", "example": "684038d6b71c9005b266feff", "type": "String" }, { "name": "Language", "key": "0-1-0-24-1", "title": "

语言，取值如下：

en：英文
ja：日文
es：西班牙语
pt：葡萄牙语
zh：中文
id：印尼语

", "example": "zh", "type": "String" }, { "name": "ProjectId", "key": "0-1-0-24-2", "title": "项目 ID", "example": "684038d6b71c9005b266fefe", "type": "String" }, { "name": "TranslationType", "key": "0-1-0-24-3", "title": "

翻译类型，取值如下：

source：源语言
target：目标语言

", "example": "source", "type": "String" } ] }, { "name": "SourceClips", "key": "0-1-0-25", "title": "源语言片段信息，仅当请求参数 Additions 中包含 SourceClips时返回。", "example": "-", "type": "Object[]", "children": [ { "name": "Id", "key": "0-1-0-25-0", "title": "片段 ID", "example": "68403b65ef3***c4835c810b", "type": "String" }, { "name": "Trim", "key": "0-1-0-25-1", "title": "片段时间信息", "example": "-", "type": "Object", "children": [ { "name": "Start", "key": "0-1-0-25-1-0", "title": "开始时间，单位为毫秒", "example": "200", "type": "Integer" }, { "name": "End", "key": "0-1-0-25-1-1", "title": "结束时间，单位为毫秒", "example": "1100", "type": "Integer" } ] }, { "name": "Volume", "key": "0-1-0-25-2", "title": "音量，取值范围为 0-100", "example": "100", "type": "Integer" }, { "name": "ClipAudio", "key": "0-1-0-25-3", "title": "片段音频信息", "example": "-", "type": "Object", "children": [ { "name": "IsAudio", "key": "0-1-0-25-3-0", "title": "是否为音频", "example": "true", "type": "Boolean" }, { "name": "Uri", "key": "0-1-0-25-3-1", "title": "文件存储路径", "example": "tos-vod-cn-v-f724fac40***19c6/example.mp4", "type": "String" }, { "name": "Vid", "key": "0-1-0-25-3-2", "title": "文件 Vid。仅在 InputVideo 和 OutputVideo 结构中此字段有值。", "example": "v0299fg***4d103gsqljht10tatbreg", "type": "String" }, { "name": "DurationSecond", "key": "0-1-0-25-3-3", "title": "文件时长，单位为秒", "example": "159.104", "type": "Double" }, { "name": "Url", "key": "0-1-0-25-3-4", "title": "文件访问 URL", "example": "https://example.volcvideo.com/example.mp4", "type": "String" }, { "name": "FileName", "key": "0-1-0-25-3-5", "title": "文件路径，可用于拼接访问地址。", "example": "video.mp4", "type": "String" } ] }, { "name": "ClipVideo", "key": "0-1-0-25-4", "title": "片段视频信息", "example": "-", "type": "Object", "children": [ { "name": "IsAudio", "key": "0-1-0-25-4-0", "title": "是否为音频", "example": "true", "type": "Boolean" }, { "name": "Uri", "key": "0-1-0-25-4-1", "title": "文件存储路径", "example": "tos-vod-cn-v-f724fac40***19c6/example.mp4", "type": "String" }, { "name": "Vid", "key": "0-1-0-25-4-2", "title": "文件 Vid。仅在 InputVideo 和 OutputVideo 结构中此字段有值。", "example": "v0299fg***4d103gsqljht10tatbreg", "type": "String" }, { "name": "DurationSecond", "key": "0-1-0-25-4-3", "title": "文件时长，单位为秒", "example": "159.104", "type": "Double" }, { "name": "Url", "key": "0-1-0-25-4-4", "title": "文件访问 URL", "example": "https://example.volcvideo.com/example.mp4", "type": "String" }, { "name": "FileName", "key": "0-1-0-25-4-5", "title": "文件路径，可用于拼接访问地址。", "example": "video.mp4", "type": "String" } ] }, { "name": "TranslationType", "key": "0-1-0-25-5", "title": "

片段翻译类型，取值如下：

source: 源语言、
target: 目标语言
background: 背景

", "example": "source", "type": "String" }, { "name": "TrackId", "key": "0-1-0-25-6", "title": "轨道 ID", "example": "68403****364cc4835c80fa", "type": "String" } ] }, { "name": "TargetClips", "key": "0-1-0-26", "title": "目标语言片段，仅当请求参数 Additions 中包含 TargetClips时返回。", "example": "-", "type": "Object[]", "children": [ { "name": "Id", "key": "0-1-0-26-0", "title": "片段 ID", "example": "68403b65ef3***c4835c810b", "type": "String" }, { "name": "Trim", "key": "0-1-0-26-1", "title": "片段时间信息", "example": "-", "type": "Object", "children": [ { "name": "Start", "key": "0-1-0-26-1-0", "title": "开始时间，单位为毫秒", "example": "200", "type": "Integer" }, { "name": "End", "key": "0-1-0-26-1-1", "title": "结束时间，单位为毫秒", "example": "1100", "type": "Integer" } ] }, { "name": "Volume", "key": "0-1-0-26-2", "title": "音量，取值范围为 0-100", "example": "100", "type": "Integer" }, { "name": "ClipAudio", "key": "0-1-0-26-3", "title": "片段音频信息", "example": "-", "type": "Object", "children": [ { "name": "IsAudio", "key": "0-1-0-26-3-0", "title": "是否为音频", "example": "true", "type": "Boolean" }, { "name": "Uri", "key": "0-1-0-26-3-1", "title": "文件存储路径", "example": "tos-vod-cn-v-f724fac40***19c6/example.mp4", "type": "String" }, { "name": "Vid", "key": "0-1-0-26-3-2", "title": "文件 Vid。仅在 InputVideo 和 OutputVideo 结构中此字段有值。", "example": "v0299fg***4d103gsqljht10tatbreg", "type": "String" }, { "name": "DurationSecond", "key": "0-1-0-26-3-3", "title": "文件时长，单位为秒", "example": "159.104", "type": "Double" }, { "name": "Url", "key": "0-1-0-26-3-4", "title": "文件访问 URL", "example": "https://example.volcvideo.com/example.mp4", "type": "String" }, { "name": "FileName", "key": "0-1-0-26-3-5", "title": "文件路径，可用于拼接访问地址。", "example": "video.mp4", "type": "String" } ] }, { "name": "ClipVideo", "key": "0-1-0-26-4", "title": "片段视频信息", "example": "-", "type": "Object", "children": [ { "name": "IsAudio", "key": "0-1-0-26-4-0", "title": "是否为音频", "example": "true", "type": "Boolean" }, { "name": "Uri", "key": "0-1-0-26-4-1", "title": "文件存储路径", "example": "tos-vod-cn-v-f724fac40***19c6/example.mp4", "type": "String" }, { "name": "Vid", "key": "0-1-0-26-4-2", "title": "文件 Vid。仅在 InputVideo 和 OutputVideo 结构中此字段有值。", "example": "v0299fg***4d103gsqljht10tatbreg", "type": "String" }, { "name": "DurationSecond", "key": "0-1-0-26-4-3", "title": "文件时长，单位为秒", "example": "159.104", "type": "Double" }, { "name": "Url", "key": "0-1-0-26-4-4", "title": "文件访问 URL", "example": "https://example.volcvideo.com/example.mp4", "type": "String" }, { "name": "FileName", "key": "0-1-0-26-4-5", "title": "文件路径，可用于拼接访问地址。", "example": "video.mp4", "type": "String" } ] }, { "name": "TranslationType", "key": "0-1-0-26-5", "title": "

片段翻译类型，取值如下：

source: 源语言、
target: 目标语言
background: 背景

", "example": "source", "type": "String" }, { "name": "TrackId", "key": "0-1-0-26-6", "title": "轨道 ID", "example": "68403****364cc4835c80fa", "type": "String" } ] }, { "name": "BackgroundClip", "key": "0-1-0-27", "title": "背景片段信息，仅当请求参数 Additions 中包含 BackgroundClip时返回。", "example": "-", "type": "Object", "children": [ { "name": "Id", "key": "0-1-0-27-0", "title": "蓝图 ID", "example": "684038d6b71c9005b266feff", "type": "String" }, { "name": "Language", "key": "0-1-0-27-1", "title": "

语言，取值如下：

en：英文
ja：日文
es：西班牙语
pt：葡萄牙语
zh：中文
id：印尼语

", "example": "zh", "type": "String" }, { "name": "ProjectId", "key": "0-1-0-27-2", "title": "项目 ID", "example": "684038d6b71c9005b266fefe", "type": "String" }, { "name": "TranslationType", "key": "0-1-0-27-3", "title": "

翻译类型，取值如下：

source：源语言
target：目标语言

", "example": "source", "type": "String" } ] }, { "name": "OperatorConfig", "key": "0-1-0-28", "title": "操作配置", "example": "-", "type": "Object", "children": [ { "name": "SubtitleRecognitionConfig", "key": "0-1-0-28-0", "title": "字幕识别配置。字幕来源默认为 OCR。", "example": "-", "type": "Object", "children": [ { "name": "RecognitionType", "key": "0-1-0-28-0-0", "title": "

字幕来源，取值如下：

OCR：从视频的画面中识别文字并生成字幕。
ASR：从视频的音轨中识别文字并生成字幕。
SourceSubtitleFile：使用您提供的源语言字幕文件。选择此项时，必须配置 SourceSubtitleFileName 参数。
SourceAndTargetSubtitleFile：使用您提供的源语言和目标语言字幕文件。选择此项时，必须同时配置 SourceSubtitleFileName 和 TargetSubtitleFileName 参数。
BilingualSubtitleFile：使用您提供的双语字幕文件。选择此项时，必须配置 BilingualSubtitleFileName 参数。
SubtitleFile：（已废弃）行为等同于 SourceSubtitleFile。

说明

使用您自行提供的字幕文件作为来源时，您必须：

预先将字幕文件作为素材上传至项目所在的点播空间。字幕文件可以是源语言字幕文件、目标语言字幕文件或双语字幕文件，支持 WebVTT、SRT 格式。
获取该字幕文件的 FileName。
配置 SourceSubtitleFileName、TargetSubtitleFileName 或 BilingualSubtitleFileName 中的一个或多个参数。

", "example": "OCR", "type": "String" }, { "name": "SourceSubtitleFileName", "key": "0-1-0-28-0-1", "title": "源语言字幕文件的 FileName。当 RecognitionType 为 SourceSubtitleFile 或 SourceAndTargetSubtitleFile 时必填。", "example": "source_subtitle.vtt", "type": "String" }, { "name": "TargetSubtitleFileName", "key": "0-1-0-28-0-2", "title": "目标语言字幕文件的 FileName。当 RecognitionType 为 SourceAndTargetSubtitleFile 时必填。", "example": "target_subtitle.vtt", "type": "String" }, { "name": "BilingualSubtitleFileName", "key": "0-1-0-28-0-3", "title": "双语字幕文件的 FileName。当 RecognitionType 为 BilingualSubtitleFile 时必填。", "example": "dual_subtitle.vtt", "type": "String" }, { "name": "SubtitleFileName", "key": "0-1-0-28-0-4", "title": "

（已废弃）字幕文件的 FileName。当字幕来源 RecognitionType 为 SubtitleFile 时必填。

注意

此参数已被 SourceSubtitleFileName、TargetSubtitleFileName 和 BilingualSubtitleFileName 替代，建议您在后续开发中使用新参数。为保证兼容，该参数仍然有效，其行为等同于 SourceSubtitleFileName。

", "example": "subtitle.vtt", "type": "String" }, { "name": "IsVision", "key": "0-1-0-28-0-5", "title": "是否开启视频理解。开启后，系统将综合理解视频画面和语音内容来生成字幕，识别结果更精准但耗时较长。默认值为 false。此模式需提交工单联系火山引擎技术支持团队申请加入白名单后方可使用。", "example": "true", "type": "Boolean" } ] }, { "name": "VoiceCloneConfig", "key": "0-1-0-28-1", "title": "声音克隆与合成配置。当翻译类型 TranslationTypeList 包含 VoiceTranslation 时，您可以通过此参数对最终合成的音频进行精细化控制。", "example": "-", "type": "Object", "children": [ { "name": "BackgroundVolume", "key": "0-1-0-28-1-0", "title": "背景音音量。用于调节最终合成视频中背景音的音量大小。默认值为 100，表示保持原始背景音音量不变。取值范围为 [0, 100]。设置为 0 表示背景音完全静音。", "example": "100", "type": "Integer" } ] } ] }, { "name": "ErrorMsg", "key": "0-1-0-29", "title": "错误信息", "example": "ErrorMsg", "type": "String" }, { "name": "ErrorCode", "key": "0-1-0-30", "title": "

错误码：

0：任务执行成功
500200：回调状态为空
500210：AI 翻译后处理失败
500100：AI 翻译工作流内部错误
500110：背景音分离失败
500120：字幕文本翻译失败
500130：语音翻译失败
500140：面容翻译失败

", "example": "0", "type": "Integer" }, { "name": "ErasedSubtitleVideo", "key": "0-1-0-31", "title": "已擦除字幕的视频信息，仅当提交 AI 翻译任务时开启擦除视频中的原有字幕时返回。", "example": "-", "type": "Object", "children": [ { "name": "IsAudio", "key": "0-1-0-31-0", "title": "是否为音频", "example": "true", "type": "Boolean" }, { "name": "Uri", "key": "0-1-0-31-1", "title": "文件存储路径", "example": "tos-vod-cn-v-f724fac40***19c6/example.mp4", "type": "String" }, { "name": "Vid", "key": "0-1-0-31-2", "title": "文件 Vid。仅在 InputVideo 和 OutputVideo 结构中此字段有值。", "example": "v0299fg***4d103gsqljht10tatbreg", "type": "String" }, { "name": "DurationSecond", "key": "0-1-0-31-3", "title": "文件时长，单位为秒", "example": "159.104", "type": "Double" }, { "name": "Url", "key": "0-1-0-31-4", "title": "文件访问 URL", "example": "https://example.volcvideo.com/example.mp4", "type": "String" }, { "name": "FileName", "key": "0-1-0-31-5", "title": "文件路径，可用于拼接访问地址。", "example": "video.mp4", "type": "String" } ] }, { "name": "InputSubtitle", "key": "0-1-0-32", "title": "源语言的字幕文件信息", "example": "-", "type": "Object", "children": [ { "name": "IsAudio", "key": "0-1-0-32-0", "title": "是否为音频", "example": "true", "type": "Boolean" }, { "name": "Uri", "key": "0-1-0-32-1", "title": "文件存储路径", "example": "tos-vod-cn-v-f724fac40***19c6/example.mp4", "type": "String" }, { "name": "Vid", "key": "0-1-0-32-2", "title": "文件 Vid。仅在 InputVideo 和 OutputVideo 结构中此字段有值。", "example": "v0299fg***4d103gsqljht10tatbreg", "type": "String" }, { "name": "DurationSecond", "key": "0-1-0-32-3", "title": "文件时长，单位为秒", "example": "159.104", "type": "Double" }, { "name": "Url", "key": "0-1-0-32-4", "title": "文件访问 URL", "example": "https://example.volcvideo.com/example.mp4", "type": "String" }, { "name": "FileName", "key": "0-1-0-32-5", "title": "文件路径，可用于拼接访问地址。", "example": "video.mp4", "type": "String" } ] }, { "name": "OutputSubtitle", "key": "0-1-0-33", "title": "目标语言的字幕文件信息", "example": "-", "type": "Object", "children": [ { "name": "IsAudio", "key": "0-1-0-33-0", "title": "是否为音频", "example": "true", "type": "Boolean" }, { "name": "Uri", "key": "0-1-0-33-1", "title": "文件存储路径", "example": "tos-vod-cn-v-f724fac40***19c6/example.mp4", "type": "String" }, { "name": "Vid", "key": "0-1-0-33-2", "title": "文件 Vid。仅在 InputVideo 和 OutputVideo 结构中此字段有值。", "example": "v0299fg***4d103gsqljht10tatbreg", "type": "String" }, { "name": "DurationSecond", "key": "0-1-0-33-3", "title": "文件时长，单位为秒", "example": "159.104", "type": "Double" }, { "name": "Url", "key": "0-1-0-33-4", "title": "文件访问 URL", "example": "https://example.volcvideo.com/example.mp4", "type": "String" }, { "name": "FileName", "key": "0-1-0-33-5", "title": "文件路径，可用于拼接访问地址。", "example": "video.mp4", "type": "String" } ] }, { "name": "BilingualSubtitle", "key": "0-1-0-34", "title": "双语的字幕文件信息", "example": "-", "type": "Object", "children": [ { "name": "IsAudio", "key": "0-1-0-34-0", "title": "是否为音频", "example": "true", "type": "Boolean" }, { "name": "Uri", "key": "0-1-0-34-1", "title": "文件存储路径", "example": "tos-vod-cn-v-f724fac40***19c6/example.mp4", "type": "String" }, { "name": "Vid", "key": "0-1-0-34-2", "title": "文件 Vid。仅在 InputVideo 和 OutputVideo 结构中此字段有值。", "example": "v0299fg***4d103gsqljht10tatbreg", "type": "String" }, { "name": "DurationSecond", "key": "0-1-0-34-3", "title": "文件时长，单位为秒", "example": "159.104", "type": "Double" }, { "name": "Url", "key": "0-1-0-34-4", "title": "文件访问 URL", "example": "https://example.volcvideo.com/example.mp4", "type": "String" }, { "name": "FileName", "key": "0-1-0-34-5", "title": "文件路径，可用于拼接访问地址。", "example": "video.mp4", "type": "String" } ] } ] } ]; return (

); ``` ## 请求示例 ```json https://vod.volcengineapi.com?Action=GetAITranslationProject&Version=2025-01-01&SpaceName=video-edit-space&ProjectId=684038d6b71c***5b266fefe&Additions=Speakers,SourceUtterances,SourceTracks,SourceClips,TargetUtterances,TargetTracks,TargetClips,BackgroundClip ``` ## 返回示例 ```json { "ResponseMetadata": { "RequestId": "20230604110420****100232280022D31", "Action": "GetAITranslationProject", "Version": "2025-01-01", "Service": "vod", "Region": "cn-north-1" }, "Result": { "ProjectInfo": { "ProjectId": "684038d6***c9005b266fefe", "ProjectVersion": "01c4fa5da***48a588a46f81e282b100", "WorkflowId": "684038d6***c9005b266fefd", "CreatedAt": "1749039318", "UpdatedAt": "1749039973", "Status": "ProcessSucceed", "InputVideoTitle": "example.mp4", "TranslationTypeList": [ "SubtitleTranslation", "VoiceTranslation", "FacialTranslation" ], "BackgroundAudio": { "Uri": "tos-vod-cn-v-f724fac40***19c6/败给月光1.mp4", "Url": "https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4", "Vid": "v0299fg***4d103gsqljht10tatbreg", "IsAudio": true, "FileName": "video.mp4", "DurationSecond": 159.104 }, "ForegroundAudio": { "Uri": "tos-vod-cn-v-f724fac40***19c6/败给月光1.mp4", "Url": "https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4", "Vid": "v0299fg***4d103gsqljht10tatbreg", "IsAudio": true, "FileName": "video.mp4", "DurationSecond": 159.104 }, "InputVideo": { "Uri": "tos-vod-cn-v-f724fac40***19c6/败给月光1.mp4", "Url": "https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4", "Vid": "v0299fg***4d103gsqljht10tatbreg", "IsAudio": true, "FileName": "video.mp4", "DurationSecond": 159.104 }, "PreviewVideo": { "Uri": "tos-vod-cn-v-f724fac40***19c6/败给月光1.mp4", "Url": "https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4", "Vid": "v0299fg***4d103gsqljht10tatbreg", "IsAudio": true, "FileName": "video.mp4", "DurationSecond": 159.104 }, "PreviewVideoMuted": { "Uri": "tos-vod-cn-v-f724fac40***19c6/败给月光1.mp4", "Url": "https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4", "Vid": "v0299fg***4d103gsqljht10tatbreg", "IsAudio": true, "FileName": "video.mp4", "DurationSecond": 159.104 }, "OutputVideo": { "Uri": "tos-vod-cn-v-f724fac40***19c6/败给月光1.mp4", "Url": "https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4", "Vid": "v0299fg***4d103gsqljht10tatbreg", "IsAudio": true, "FileName": "video.mp4", "DurationSecond": 159.104 }, "VoiceTranslationVideo": { "Uri": "tos-vod-cn-v-f724fac40***19c6/败给月光1.mp4", "Url": "https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4", "Vid": "v0299fg***4d103gsqljht10tatbreg", "IsAudio": true, "FileName": "video.mp4", "DurationSecond": 159.104 }, "FacialTranslationVideo": { "Uri": "tos-vod-cn-v-f724fac40***19c6/败给月光1.mp4", "Url": "https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4", "Vid": "v0299fg***4d103gsqljht10tatbreg", "IsAudio": true, "FileName": "video.mp4", "DurationSecond": 159.104 }, "Speakers": [ { "Id": "68403b65e***4cc4835c80f4", "Name": "Speaker 1", "Voice": "zh_female_***_bigtts", "ProjectId": "684038d***1c9005b266fefe", "CurrentVoice": "zh_male_***_bigtts" } ], "SourceUtterances": [ { "Id": "68403b65***64cc4835c8141", "Text": "文本内容", "ClipId": "68403b65ef364cc4835c8104", "Status": "online", "SourceId": "000000000000000000000000", "ProjectId": "684038d6b71c9005b266fefe", "SpeakerId": "68403b65***64cc4835c80f4", "BlueprintId": "684038d6b71c9005b266feff", "TranslationType": "source", "IsFacialTranslation": true } ], "TargetUtterances": [ { "Id": "68403b65***64cc4835c8141", "Text": "文本内容", "ClipId": "68403b65ef364cc4835c8104", "Status": "online", "SourceId": "000000000000000000000000", "ProjectId": "684038d6b71c9005b266fefe", "SpeakerId": "68403b65***64cc4835c80f4", "BlueprintId": "684038d6b71c9005b266feff", "TranslationType": "source", "IsFacialTranslation": true } ], "SourceTracks": [ { "Id": "68403b65ef364cc4835c80f9", "SpeakerId": "68403b65ef364cc4835c80f4", "BlueprintId": "684038d6b71c9005b266feff", "TranslationType": "source" } ], "TargetTracks": [ { "Id": "68403b65ef364cc4835c80f9", "SpeakerId": "68403b65ef364cc4835c80f4", "BlueprintId": "684038d6b71c9005b266feff", "TranslationType": "source" } ], "SourceBlueprints": [ { "Id": "684038d6b71c9005b266feff", "Language": "zh", "ProjectId": "684038d6b71c9005b266fefe", "TranslationType": "source" } ], "TargetBlueprints": [ { "Id": "684038d6b71c9005b266feff", "Language": "zh", "ProjectId": "684038d6b71c9005b266fefe", "TranslationType": "source" } ], "SourceClips": [ { "Id": "68403b65ef364cc4835c810b", "Trim": { "End": 1100, "Start": 200 }, "Volume": 100, "TrackId": "68403b65ef364cc4835c80fa", "ClipAudio": { "Uri": "tos-vod-cn-v-f724fac40***19c6/败给月光1.mp4", "Url": "https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4", "Vid": "v0299fg***4d103gsqljht10tatbreg", "IsAudio": true, "FileName": "video.mp4", "DurationSecond": 159.104 }, "ClipVideo": { "Uri": "tos-vod-cn-v-f724fac40***19c6/败给月光1.mp4", "Url": "https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4", "Vid": "v0299fg***4d103gsqljht10tatbreg", "IsAudio": true, "FileName": "video.mp4", "DurationSecond": 159.104 }, "TranslationType": "source" } ], "TargetClips": [ { "Id": "68403b65ef364cc4835c810b", "Trim": { "End": 1100, "Start": 200 }, "Volume": 100, "TrackId": "68403b65ef364cc4835c80fa", "ClipAudio": { "Uri": "tos-vod-cn-v-f724fac40***19c6/败给月光1.mp4", "Url": "https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4", "Vid": "v0299fg***4d103gsqljht10tatbreg", "IsAudio": true, "FileName": "video.mp4", "DurationSecond": 159.104 }, "ClipVideo": { "Uri": "tos-vod-cn-v-f724fac40***19c6/败给月光1.mp4", "Url": "https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4", "Vid": "v0299fg***4d103gsqljht10tatbreg", "IsAudio": true, "FileName": "video.mp4", "DurationSecond": 159.104 }, "TranslationType": "source" } ], "BackgroundClip": { "Id": "684038d6b71c9005b266feff", "Language": "zh", "ProjectId": "684038d6b71c9005b266fefe", "TranslationType": "source" }, "OperatorConfig": { "SubtitleRecognitionConfig": { "RecognitionType": "OCR" } }, "ErrorMsg": "ErrorMsg", "ErrorCode": 0, "ErasedSubtitleVideo": { "Uri": "tos-vod-cn-v-f724fac40***19c6/败给月光1.mp4", "Url": "https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4", "Vid": "v0299fg***4d103gsqljht10tatbreg", "IsAudio": true, "FileName": "video.mp4", "DurationSecond": 159.104 }, "InputSubtitle": { "Uri": "tos-vod-cn-v-f724fac40***19c6/败给月光1.mp4", "Url": "https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4", "Vid": "v0299fg***4d103gsqljht10tatbreg", "IsAudio": true, "FileName": "video.mp4", "DurationSecond": 159.104 }, "OutputSubtitle": { "Uri": "tos-vod-cn-v-f724fac40***19c6/败给月光1.mp4", "Url": "https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4", "Vid": "v0299fg***4d103gsqljht10tatbreg", "IsAudio": true, "FileName": "video.mp4", "DurationSecond": 159.104 } } } } ``` ## 错误码本接口无特有的错误码。更多信息请见[公共错误码](https://www.volcengine.com/docs/4/65595)。