GetAITranslationProject - 获取 AI 翻译项目详细信息--视频点播-火山引擎

文档中心

立即注册

导航

GetAITranslationProject - 获取 AI 翻译项目详细信息

最近更新时间：2025.06.05 15:38:12首次发布时间：2025.06.05 15:38:12

调用 GetAITranslationProject 接口获取 AI 翻译项目的详细信息，包括项目基本信息和附加信息（说话者信息、源语言对话文本和目标语言对话文本等）。

注意事项

本接口的单用户 QPS 限制为 10 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见 QPS 限制。

请求说明

请求地址：https://vod.volcengineapi.com?Action=GetAITranslationProject&Version=2025-01-01

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共请求参数。

参数	类型	是否必选	示例值	描述
Action	String	是	`GetAITranslationProject`	接口名称。当前 API 的名称为 `GetAITranslationProject`。
Version	String	是	`2025-01-01`	接口版本。当前 API 的版本为 `2025-01-01`。
SpaceName	String	是	`test`	点播空间名。您可通过以下方式获取空间名称：在视频点播控制台空间管理页面查看当前账号下所有空间的名称。调用 ListSpace 接口获取当前账号下所有空间的名称。
ProjectId	String	是	`684038d6b71***05b266fefe`	项目 ID。您可通过以下方式获取项目 ID：在 SubmitAITranslationWorkflow 接口的返回参数中获取。配置 AI 翻译任务执行完成事件。
Additions	String	否	`Speakers,SourceUtterances,TargetClips`	指定需要返回的附加信息类型，多个类型用逗号分隔。不传此参数时仅返回项目基本信息。支持的附加信息类型如下： `Speakers`：说话者信息 `SourceUtterances`：源对话文本 `SourceTracks`：源轨道信息 `SourceClips`：源片段信息 `TargetUtterances`：目标对话文本 `TargetTracks`：目标轨道信息 `TargetClips`：目标片段信息 `BackgroundClip`：背景片段信息

返回参数

下表仅列出本接口特有的返回参数。更多信息请见公共返回参数。

参数	类型	示例值	描述
ProjectInfo	Object	`-`	项目信息
ProjectId	String	`684038d6b71c9005b266fefe`	项目 ID
ProjectVersion	String	`01c4fa5da3d648a588a46f81e282b100`	项目版本
WorkflowId	String	`684038d6b71c9005b266fefd`	工作流 ID
CreatedAt	String	`1749039318`	项目创建时间，Unix 时间戳，精度为秒。
UpdatedAt	String	`1749039973`	项目更新时间，Unix 时间戳，精度为秒。
Status	String	`ProcessSucceed`	项目状态，取值如下： `InProcessing`：处理中 `ProcessSucceed`：处理完成 `ProcessFailed`：处理失败 `InExporting`：导出中 `ExportSucceed`：导出完成 `ExportFailed`：导出失败
InputVideoTitle	String	`example.mp4`	输入视频名称
TranslationTypeList	String[]	`["SubtitleTranslation","VoiceTranslation", "FacialTranslation"]`	执行的翻译类型组合，支持以下选项： `["SubtitleTranslation"]`：仅文本翻译。 `["SubtitleTranslation","VoiceTranslation"]`：文本和语音翻译。 `["SubtitleTranslation","VoiceTranslation", "FacialTranslation"]`：文本、语音和面容翻译。说明翻译类型详细介绍请见声影智译。
BackgroundAudio	Object	`-`	背景音频信息
IsAudio	Boolean	`true`	是否为音频
Uri	String	`tos-vod-cn-v-f724fac4091119c6/败给月光1.mp4`	文件存储路径
Vid	String	`v0299fg***4d103gsqljht10tatbreg`	文件 Vid。仅在 `InputVideo` 和 `OutputVideo` 中此字段有值。
DurationSecond	Double	`159.104`	文件时长，单位为秒
Url	String	`https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4`	文件访问 URL
ForegroundAudio	Object	`-`	前景音频信息
IsAudio	Boolean	`true`	是否为音频
Uri	String	`tos-vod-cn-v-f724fac4091119c6/败给月光1.mp4`	文件存储路径
Vid	String	`v0299fg***4d103gsqljht10tatbreg`	文件 Vid。仅在 `InputVideo` 和 `OutputVideo` 中此字段有值。
DurationSecond	Double	`159.104`	文件时长，单位为秒
Url	String	`https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4`	文件访问 URL
InputVideo	Object	`-`	输入视频信息
IsAudio	Boolean	`true`	是否为音频
Uri	String	`tos-vod-cn-v-f724fac4091119c6/败给月光1.mp4`	文件存储路径
Vid	String	`v0299fg***4d103gsqljht10tatbreg`	文件 Vid。仅在 `InputVideo` 和 `OutputVideo` 中此字段有值。
DurationSecond	Double	`159.104`	文件时长，单位为秒
Url	String	`https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4`	文件访问 URL
PreviewVideo	Object	`-`	预览视频信息
IsAudio	Boolean	`true`	是否为音频
Uri	String	`tos-vod-cn-v-f724fac4091119c6/败给月光1.mp4`	文件存储路径
Vid	String	`v0299fg***4d103gsqljht10tatbreg`	文件 Vid。仅在 `InputVideo` 和 `OutputVideo` 中此字段有值。
DurationSecond	Double	`159.104`	文件时长，单位为秒
Url	String	`https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4`	文件访问 URL
PreviewVideoMuted	Object	`-`	预览视频无音频
IsAudio	Boolean	`true`	是否为音频
Uri	String	`tos-vod-cn-v-f724fac4091119c6/败给月光1.mp4`	文件存储路径
Vid	String	`v0299fg***4d103gsqljht10tatbreg`	文件 Vid。仅在 `InputVideo` 和 `OutputVideo` 中此字段有值。
DurationSecond	Double	`159.104`	文件时长，单位为秒
Url	String	`https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4`	文件访问 URL
OutputVideo	Object	`-`	输出视频信息
IsAudio	Boolean	`true`	是否为音频
Uri	String	`tos-vod-cn-v-f724fac4091119c6/败给月光1.mp4`	文件存储路径
Vid	String	`v0299fg***4d103gsqljht10tatbreg`	文件 Vid。仅在 `InputVideo` 和 `OutputVideo` 中此字段有值。
DurationSecond	Double	`159.104`	文件时长，单位为秒
Url	String	`https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4`	文件访问 URL
VoiceTranslationVideo	Object	`-`	语音翻译视频
IsAudio	Boolean	`true`	是否为音频
Uri	String	`tos-vod-cn-v-f724fac4091119c6/败给月光1.mp4`	文件存储路径
Vid	String	`v0299fg***4d103gsqljht10tatbreg`	文件 Vid。仅在 `InputVideo` 和 `OutputVideo` 中此字段有值。
DurationSecond	Double	`159.104`	文件时长，单位为秒
Url	String	`https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4`	文件访问 URL
FacialTranslationVideo	Object	`-`	面容翻译视频
IsAudio	Boolean	`true`	是否为音频
Uri	String	`tos-vod-cn-v-f724fac4091119c6/败给月光1.mp4`	文件存储路径
Vid	String	`v0299fg***4d103gsqljht10tatbreg`	文件 Vid。仅在 `InputVideo` 和 `OutputVideo` 中此字段有值。
DurationSecond	Double	`159.104`	文件时长，单位为秒
Url	String	`https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4`	文件访问 URL
Speakers	Object[]	`-`	说话人信息，仅当请求参数 `Additions` 中包含 `Speakers` 时返回。
Id	String	`68403b65ef364cc4835c80f4`	说话人 ID
Name	String	`Speaker 1`	说话人名字
Voice	String	`DiT_9e673c550103`	说话人音色
ProjectId	String	`684038d6b71c9005b266fefe`	项目 ID
SourceUtterances	Object[]	`-`	源对话文本，仅当请求参数 `Additions` 中包含 `SourceUtterances` 时返回。
Id	String	`68403b65ef364cc4835c8141`	文本 ID
SpeakerId	String	`68403b65ef364cc4835c80f4`	说话人 ID
BlueprintId	String	`684038d6b71c9005b266feff`	蓝图 ID
ClipId	String	`68403b65ef364cc4835c8104`	片段 ID
Text	String	`文本内容`	文本内容
ProjectId	String	`684038d6b71c9005b266fefe`	项目 ID
IsFacialTranslation	Boolean	`false`	是否为面容翻译
TranslationType	String	`source`	文本翻译类别，取值如下： `source`：源语言 `target`：目标语言
Status	String	`online`	文本状态，取值如下： `online`: 线上 `need_update`: 需要更新
SourceId	String	`000000000000000000000000`	源文本 ID，仅当类型为 `target` 时生效
TargetUtterances	Object[]	`-`	目标对话文本，仅当请求参数 `Additions` 中包含 `TargetUtterances` 时返回。
Id	String	`68403b65ef364cc4835c8141`	文本 ID
SpeakerId	String	`68403b65ef364cc4835c80f4`	说话人 ID
BlueprintId	String	`684038d6b71c9005b266feff`	蓝图 ID
ClipId	String	`68403b65ef364cc4835c8104`	片段 ID
Text	String	`文本内容`	文本内容
ProjectId	String	`684038d6b71c9005b266fefe`	项目 ID
IsFacialTranslation	Boolean	`false`	是否为面容翻译
TranslationType	String	`source`	文本翻译类别，取值如下： `source`：源语言 `target`：目标语言
Status	String	`online`	文本状态，取值如下： `online`: 线上 `need_update`: 需要更新
SourceId	String	`000000000000000000000000`	源文本 ID，仅当类型为 `target` 时生效
SourceTracks	Object[]	`-`	源轨道信息，仅当请求参数 `Additions` 中包含 `SourceTracks` 时返回。
Id	String	`68403b65ef364cc4835c80f9`	轨道 ID
BlueprintId	String	`684038d6b71c9005b266feff`	蓝图 ID
SpeakerId	String	`68403b65ef364cc4835c80f4`	说话者 ID
TranslationType	String	`source`	轨道翻译类型，取值如下： `source`: 源语言 `target`: 目标语言
TargetTracks	Object[]	`-`	源轨道信息，仅当请求参数 `Additions` 中包含 `TargetTracks` 时返回。
Id	String	`68403b65ef364cc4835c80f9`	轨道 ID
BlueprintId	String	`684038d6b71c9005b266feff`	蓝图 ID
SpeakerId	String	`68403b65ef364cc4835c80f4`	说话者 ID
TranslationType	String	`source`	轨道翻译类型，取值如下： `source`: 源语言 `target`: 目标语言
SourceBlueprints	Object[]	`-`	源语言蓝图
Id	String	`684038d6b71c9005b266feff`	蓝图 ID
Language	String	`zh`	语言，取值如下： `en`：英文 `ja`：日文 `es`：西班牙语 `pt`：葡萄牙语 `zh`：中文 `id`：印尼语
ProjectId	String	`684038d6b71c9005b266fefe`	项目 ID
TranslationType	String	`source`	翻译类型，取值如下： `source`：源语言 `target`：目标语言
TargetBlueprints	Object[]	`-`	目标语言蓝图
Id	String	`684038d6b71c9005b266feff`	蓝图 ID
Language	String	`zh`	语言，取值如下： `en`：英文 `ja`：日文 `es`：西班牙语 `pt`：葡萄牙语 `zh`：中文 `id`：印尼语
ProjectId	String	`684038d6b71c9005b266fefe`	项目 ID
TranslationType	String	`source`	翻译类型，取值如下： `source`：源语言 `target`：目标语言
SourceClips	Object[]	`-`	源片段信息，仅当请求参数 `Additions` 中包含 `SourceClips` 时返回。
Id	String	`68403b65ef364cc4835c810b`	片段 ID
Trim	Object	`-`	片段时间信息
Start	Integer	`200`	开始时间，单位毫秒
End	Integer	`1100`	结束时间，单位毫秒
Volume	Integer	`100`	音量，取值为 0-100
ClipAudio	Object	`-`	片段音频信息
IsAudio	Boolean	`true`	是否为音频
Uri	String	`tos-vod-cn-v-f724fac4091119c6/败给月光1.mp4`	文件存储路径
Vid	String	`v0299fg***4d103gsqljht10tatbreg`	文件 Vid。仅在 `InputVideo` 和 `OutputVideo` 中此字段有值。
DurationSecond	Double	`159.104`	文件时长，单位为秒
Url	String	`https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4`	文件访问 URL
ClipVideo	Object	`-`	片段视频信息
IsAudio	Boolean	`true`	是否为音频
Uri	String	`tos-vod-cn-v-f724fac4091119c6/败给月光1.mp4`	文件存储路径
Vid	String	`v0299fg***4d103gsqljht10tatbreg`	文件 Vid。仅在 `InputVideo` 和 `OutputVideo` 中此字段有值。
DurationSecond	Double	`159.104`	文件时长，单位为秒
Url	String	`https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4`	文件访问 URL
TranslationType	String	`source`	片段翻译类型，取值如下： `source`: 源语言、 `target`: 目标语言 `background`: 背景
TrackId	String	`68403b65ef364cc4835c80fa`	轨道 ID
TargetClips	Object[]	`-`	目标片段，仅当请求参数 `Additions` 中包含 `TargetClips` 时返回。
Id	String	`68403b65ef364cc4835c810b`	片段 ID
Trim	Object	`-`	片段时间信息
Start	Integer	`200`	开始时间，单位毫秒
End	Integer	`1100`	结束时间，单位毫秒
Volume	Integer	`100`	音量，取值为 0-100
ClipAudio	Object	`-`	片段音频信息
IsAudio	Boolean	`true`	是否为音频
Uri	String	`tos-vod-cn-v-f724fac4091119c6/败给月光1.mp4`	文件存储路径
Vid	String	`v0299fg***4d103gsqljht10tatbreg`	文件 Vid。仅在 `InputVideo` 和 `OutputVideo` 中此字段有值。
DurationSecond	Double	`159.104`	文件时长，单位为秒
Url	String	`https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4`	文件访问 URL
ClipVideo	Object	`-`	片段视频信息
IsAudio	Boolean	`true`	是否为音频
Uri	String	`tos-vod-cn-v-f724fac4091119c6/败给月光1.mp4`	文件存储路径
Vid	String	`v0299fg***4d103gsqljht10tatbreg`	文件 Vid。仅在 `InputVideo` 和 `OutputVideo` 中此字段有值。
DurationSecond	Double	`159.104`	文件时长，单位为秒
Url	String	`https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4`	文件访问 URL
TranslationType	String	`source`	片段翻译类型，取值如下： `source`: 源语言、 `target`: 目标语言 `background`: 背景
TrackId	String	`68403b65ef364cc4835c80fa`	轨道 ID
BackgroundClip	Object	`-`	背景片段信息，仅当请求参数 `Additions` 中包含 `BackgroundClip` 时返回。
Id	String	`684038d6b71c9005b266feff`	蓝图 ID
Language	String	`zh`	语言，取值如下： `en`：英文 `ja`：日文 `es`：西班牙语 `pt`：葡萄牙语 `zh`：中文 `id`：印尼语
ProjectId	String	`684038d6b71c9005b266fefe`	项目 ID
TranslationType	String	`source`	翻译类型，取值如下： `source`：源语言 `target`：目标语言
OperatorConfig	Object	`-`	操作配置
SubtitleRecognitionConfig	Object	`-`	字幕识别配置
RecognitionType	String	`OCR`	字幕识别类型，取值如下： `OCR`：视频画面文字识别 `ASR`：语音识别默认为 OCR。
ErrorMsg	String	`ErrorMsg`	错误信息
ErrorCode	Integer	`0`	错误码： `0`：任务执行成功 `500200`：回调状态为空 `500210`：AI 翻译后处理失败 `500100`：AI 翻译工作流内部错误 `500110`：背景音分离失败 `500120`：字幕文本翻译失败 `500130`：语音翻译失败 `500140`：面容翻译失败

请求示例

https://vod.volcengineapi.com?Action=GetAITranslationProject&Version=2025-01-01&SpaceName=video-edit-space&ProjectId=684038d6b71c9005b266fefe&Additions=Speakers,SourceUtterances,SourceTracks,SourceClips,TargetUtterances,TargetTracks,TargetClips,BackgroundClip

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20250605151812FEE6A903608FB01F51CA",
    "Action": "GetAITranslationProject",
    "Version": "2025-01-01",
    "Service": "vod",
    "Region": "cn-north-1"
  },
  "Result": {
    "ProjectInfo": {
      "ProjectId": "684038d6b71c9005b266fefe",
      "ProjectVersion": "978d8d56c48542d8be61d899129c48df",
      "WorkflowId": "684038d6b71c9005b266fefd",
      "CreatedAt": "1749039318",
      "UpdatedAt": "1749041560",
      "Status": "ProcessSucceed",
      "InputVideoTitle": "败给月光1.mp4",
      "TranslationTypeList": [
        "SubtitleTranslation",
        "VoiceTranslation",
        "FacialTranslation"
      ],
      "BackgroundAudio": {
        "IsAudio": true,
        "Uri": "tos-vod-cn-v-f724fac4091119c6/77b2d8b720124a3289309747718051e0_others.aac",
        "Vid": "",
        "DurationSecond": 159.10000610351562,
        "Url": "https://example.volcvideo.com/77b2d8b720124a3289309747718051e0_others.aac?preview=1&auth_key=1749194292-r0-u0-7204f2984effd5c2711e0f55679f1b16"
      },
      "ForegroundAudio": {
        "IsAudio": true,
        "Uri": "tos-vod-cn-v-f724fac4091119c6/77b2d8b720124a3289309747718051e0_speech.aac",
        "Vid": "",
        "DurationSecond": 159.10000610351562,
        "Url": "https://example.volcvideo.com/77b2d8b720124a3289309747718051e0_speech.aac"
      },
      "InputVideo": {
        "IsAudio": false,
        "Uri": "tos-vod-cn-v-f724fac4091119c6/败给月光1.mp4",
        "Vid": "v0299fg10064d103gsqljht10tatbreg",
        "DurationSecond": 159.104,
        "Url": "https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4"
      },
      "PreviewVideo": {
        "IsAudio": false,
        "Uri": "tos-vod-cn-v-f724fac4091119c6/a2cfad5e718b42c58561f867a76b4b61-facial.mp4",
        "Vid": "",
        "DurationSecond": 159.10000610351562,
        "Url": "https://example.volcvideo.com/a2cfad5e718b42c58561f867a76b4b61-facial.mp4"
      },
      "PreviewVideoMuted": {
        "IsAudio": false,
        "Uri": "tos-vod-cn-v-f724fac4091119c6/a2cfad5e718b42c58561f867a76b4b61-mute.mp4",
        "Vid": "",
        "DurationSecond": 159.10000610351562,
        "Url": "https://example.volcvideo.com/a2cfad5e718b42c58561f867a76b4b61-mute.mp4"
      },
      "OutputVideo": {
        "IsAudio": false,
        "Uri": "tos-vod-cn-v-f724fac4091119c6/a2cfad5e718b42c58561f867a76b4b61-facial.mp4",
        "Vid": "v0d99fg10064d10435qljht287ouip70",
        "DurationSecond": 159.10000610351562,
        "Url": "https://example.volcvideo.com/a2cfad5e718b42c58561f867a76b4b61-facial.mp4"
      },
      "VoiceTranslationVideo": {
        "IsAudio": false,
        "Uri": "tos-vod-cn-v-f724fac4091119c6/7cac1ff9584e41d7b079b20ffbc78e42-whole.mp4",
        "Vid": "",
        "DurationSecond": 159.10000610351562,
        "Url": "https://example.volcvideo.com/7cac1ff9584e41d7b079b20ffbc78e42-whole.mp4"
      },
      "FacialTranslationVideo": {
        "IsAudio": false,
        "Uri": "tos-vod-cn-v-f724fac4091119c6/a2cfad5e718b42c58561f867a76b4b61-facial.mp4",
        "Vid": "",
        "DurationSecond": 159.10000610351562,
        "Url": "https://example.volcvideo.com/a2cfad5e718b42c58561f867a76b4b61-facial.mp4"
      },
      "Speakers": [],
      "SourceUtterances": [],
      "TargetUtterances": [],
      "SourceTracks": [],
      "TargetTracks": [],
      "SourceBlueprints": [
        {
          "Id": "684038d6b71c9005b266feff",
          "Language": "zh",
          "ProjectId": "684038d6b71c9005b266fefe",
          "TranslationType": "source"
        }
      ],
      "TargetBlueprints": [
        {
          "Id": "684038d6b71c9005b266ff00",
          "Language": "en",
          "ProjectId": "684038d6b71c9005b266fefe",
          "TranslationType": "target"
        }
      ],
      "SourceClips": [],
      "TargetClips": [],
      "BackgroundClip": null,
      "OperatorConfig": {
        "SubtitleRecognitionConfig": {
          "RecognitionType": "OCR"
        }
      },
      "ErrorMsg": "",
      "ErrorCode": 0
    }
  }
}

错误码

本接口无特有的错误码。更多信息请见公共错误码。