SubmitAITranslationWorkflow - 提交 AI 翻译任务--视频点播-火山引擎

文档中心

立即注册

导航

SubmitAITranslationWorkflow - 提交 AI 翻译任务

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

调用 SubmitAITranslationWorkflow 接口为指定视频提交 AI 翻译任务，支持配置源语言、目标语言和翻译类型（文本翻译、语音翻译和面容翻译）。

使用说明

成功提交后，系统将生成异步执行的媒体处理任务。您可配置 AI 翻译任务执行完成事件通知获取处理结果。

注意事项

费用说明：AI 翻译任务会产生视频 AI 费用，具体参见视频 AI 应用计费。
本接口的单用户 QPS 限制为 10 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见 QPS 限制。

请求说明

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

调试

API Explorer

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

去调试

请求参数

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

Query

参数	类型	是否必选	示例值	描述
Action	String	是	`SubmitAITranslationWorkflow`	接口名称。当前 API 的名称为 `SubmitAITranslationWorkflow`。
Version	String	是	`2025-01-01`	接口版本。当前 API 的版本为 `2025-01-01`。

Body

参数	类型	是否必选	示例值	描述
SpaceName	String	是	`test`	点播空间名。您可通过以下方式获取空间名称：在视频点播控制台空间管理页面查看当前账号下所有空间的名称。调用 ListSpace 接口获取当前账号下所有空间的名称。
Vid	String	是	`v0ccfeg7007acsg***fog65ubr7niqng`	视频 ID。音视频上传至视频点播服务后，您可通过媒资上传完成事件获取 `Vid`。
TranslationConfig	Object	是	`-`	AI 翻译配置
SourceLanguage	String	是	`zh`	源语言，取值如下： `zh`：中文 `en`：英文
TargetLanguage	String	是	`ja`	目标语言，取值如下： `en`：英文 `ja`：日文 `es`：西班牙语 `pt`：葡萄牙语 `zh`：中文 `id`：印尼语
TranslationTypeList	String[]	是	`["SubtitleTranslation","VoiceTranslation"]`	需要执行的翻译类型组合，支持以下选项： `["SubtitleTranslation"]`：仅文本翻译。 `["SubtitleTranslation","VoiceTranslation"]`：文本和语音翻译。 `["SubtitleTranslation","VoiceTranslation", "FacialTranslation"]`：文本、语音和面容翻译。说明翻译类型详细介绍请见声影智译。
OperatorConfig	Object	是	`-`	操作配置
SubtitleRecognitionConfig	Object	否	`-`	字幕识别配置
RecognitionType	String	是	`OCR`	字幕识别类型，取值如下： `OCR`：视频画面文字识别 `ASR`：语音识别默认为 OCR。

返回参数

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

参数	类型	示例值	描述
ProjectBaseInfo	Object	`-`	项目基础信息
ProjectId	String	`684038d6b71c9005b266fefe`	项目 ID
ProjectVersion	String	`01c4fa5da3d648a588a46f81e282b100`	项目版本

请求示例

POST https://vod.volcengineapi.com?Action=SubmitAITranslationWorkflow&Version=2025-01-01
{
  "SpaceName": "test",
  "Vid": "v0ccfeg7007acsg***fog65ubr7niqng",
  "TranslationConfig": {
    "SourceLanguage": "zh",
    "TargetLanguage": "ja",
    "TranslationTypeList": [
      "SubtitleTranslation",
      "VoiceTranslation"
    ]
  },
  "OperatorConfig": {}
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20230604110420****100232280022D31",
    "Action": "SubmitAITranslationWorkflow",
    "Version": "2025-01-01",
    "Service": "vod",
    "Region": "cn-north-1"
  },
  "Result": {
    "ProjectBaseInfo": {
      "ProjectId": "684038d6b71c9005b266fefe",
      "ProjectVersion": "01c4fa5da3d648a588a46f81e282b100"
    }
  }
}

错误码

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