文档

SubmitVideoTranslationJob - 提交视频翻译任务

更新时间:

通过本接口,您可以提交视频翻译任务。当前支持字幕级翻译,即将视频中出现的字幕翻译为指定语言,未来会拓展支持声音(口播)级翻译与面容(口型)适配。

接口说明

提交视频翻译任务,返回 JobId,后续可通过 JobId 调用 GetSmartHandleJob 接口来获取任务的状态及结果信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
ice:SubmitVideoTranslationJob
  • 全部资源
    *

请求参数

名称类型必填描述示例值
InputConfigstring
  • 视频翻译任务的输入参数
  • 支持以视频、字幕文件作为输入
  • 符合 JSON 格式
{"Type":"Video","Media":"https://your-bucket.oss-cn-shanghai.aliyuncs.com/xxx.mp4"}
EditingConfigstring
  • 视频翻译任务的配置参数
  • 符合 JSON 格式
{"SourceLanguage":"zh","TargetLanguage":"en","DetextArea":"Auto"}
OutputConfigstring
  • 视频翻译任务的输出参数‘
  • 支持以视频类型、字幕文件类型输出
{"MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-object.mp4"}
Titlestring
  • 任务标题
测试标题
Descriptionstring
  • 任务描述
测试描述
UserDatastring
  • 自定义信息
测试 UserData
ClientTokenstring
  • ClientToken
测试 ClientToken

InputConfig

参数说明

  1. Type:输入类型,取值范围:
    • Video:输入为视频
    • Subtitle:输入为字幕文件
  2. Media:视频素材,Type 为 Video 时设置,支持:
    • IMS 媒资 ID
    • OSS 地址
  3. Subtitle:SRT 字幕文件,Type 为 Subtitle 时设置,支持:
    • OSS 地址

参数示例

输入为视频,MediaId:

{
    "Type": "Video",
    "Media": "*****c80cc0071edbf92f6e7c44*****"
}

输入为视频,OSS 地址:

{
    "Type": "Video",
    "Media": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/video.mp4"
}

输入为字幕文件,OSS 地址:

{
    "Type": "Subtitle",
    "Media": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/subtitle.srt"
}

EditingConfig

参数说明

  • SourceLanguage:原语言,取值范围:
    • zh:汉语
  • TargetLanguage:目标语言,取值范围:
  • DetextArea:字幕擦除区域,如不填,则不做字幕擦除。
    • Auto:智能识别字幕位置
    • [x, y, width, height]:指定擦除范围,其中:
      • x:字幕框左上角距离视频左上角的横向距离比例,取值范围:[0, 1]
      • y:字幕框左上角距离视频左上角的竖向距离比例,取值范围:[0, 1]
      • width:字幕框宽度相对于视频宽度的比例,取值范围:[0, 1]
      • height:字幕框高度相对于视频高度的比例,取值范围:[0, 1]
  • SupportEditing:是否开启支持二次剪辑,取值范围:
    • true:开启,保留处理过程中产生的所有中间文件,并生成剪辑工程用于二次创作
    • false:不开启,默认值,不保留中间文件与生成剪辑工程
  • SubtitleTranslate:字幕翻译配置
    • TextSource:字幕来源,取值范围:
      • OCR:翻译字幕来源视频中 OCR 识别,不填默认为此值
      • SubtitleFile:翻译字幕来源于传入的字幕文件
    • OcrArea:OCR 识别区域,如不填,默认为智能识别,取值范围:
      • Auto:智能识别字幕位置
      • [x, y, width, height]:指定识别范围,其中:
        • x:字幕框左上角距离视频左上角的横向距离比例,取值范围:[0, 1]
        • y:字幕框左上角距离视频左上角的竖向距离比例,取值范围:[0, 1]
        • width:字幕框宽度相对于视频宽度的比例,取值范围:[0, 1]
        • height:字幕框高度相对于视频高度的比例,取值范围:[0, 1]
    • SubtitleConfig:合成字幕效果设置,用于自定义成片字幕效果,参数与剪辑合成中 Timeline 的字幕参数一致,参考:SubtitleTrackClip 配置

参数示例

输入中文,输出英文,智能字幕擦除

{
    "SourceLanguage": "zh",
    "TargetLanguage": "en",
    "DetextArea": "Auto"
}

输入中文,输出英文,指定字幕擦除位置

{
    "SourceLanguage": "zh",
    "TargetLanguage": "en",
    "DetextArea": "[0.1,0.85,0.8,0.15]"
}

输入中文,输出英文,不进行字幕擦除,并自定义翻译后字幕位置

{
    "SourceLanguage": "zh",
    "TargetLanguage": "en",
    "SubtitleTranslate": {
        "TextSource": "OCR",
        "OcrArea": "Auto",
        "SubtitleConfig": {
            "Alignment" : "Center"
            "Y": 0.8
        }
    }
}

OutputConfig

参数说明

  • MediaURL:输出文件地址,支持输出视频格式或字幕文件格式

参数示例

输出视频格式

{
    "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/video.mp4"
}

输出字幕格式

{
    "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/subtitle.srt"
}

返回参数

名称类型描述示例值
object

Schema of Response

RequestIdstring

请求 ID

******3B-0E1A-586A-AC29-742247******
Successboolean

调用是否成功。

取值:

  • true: 成功
  • false:失败
true
Dataobject

响应数据

JobIdstring

视频翻译任务 ID

****d718e2ff4f018ccf419a7b71****

示例

正常返回示例

JSON格式

{
  "RequestId": "******3B-0E1A-586A-AC29-742247******",
  "Success": true,
  "Data": {
    "JobId": "****d718e2ff4f018ccf419a7b71****"
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
暂无变更历史