视频翻译参数介绍与示例_智能媒体服务(IMS)-阿里云帮助中心

本文介绍了有关视频翻译接口 SubmitVideoTranslationJob 的参数与示例。

参数说明

参数名	类型	必填项	名称	描述
InputConfig	String	是	输入配置	JSON 格式字符串内部参数见下方
OutputConfig	String	是	输出配置	JSON 格式字符串内部参数见下方
EditingConfig	String	是	翻译配置	JSON 格式字符串内部参数见下方
Title	String	否	标题
Description	String	否	描述
UserData	String	否	自定义信息

InputConfig

参数名	类型	必填项	名称	描述
Type	String	是	输入类型	取值范围： Video 视频 Audio 音频 Subtitle 字幕
Video	String	否	视频媒资 Id 或地址	Type 为 Video 时传入支持传入：媒资 Id 本账号下的 OSS 地址其它公网可访问的地址
Audio	String	否	音频媒资 Id 或地址	Type 为 Audio 时传入支持传入：媒资 Id 本账号下的 OSS 地址其它公网可访问的地址
Subtitle	String	否	字幕媒资 Id 或地址	Type 为 Subtitle 时传入支持传入：媒资 Id 本账号下的 OSS 地址其它公网可访问的地址

OutputConfig

参数名

类型

必填项

名称

描述

MediaURL

String

是

输出地址

填写本账号下的 OSS 地址

路径中请附带扩展名，会依据扩展名判断输出类型，扩展名支持：
- mp4

EditingConfig

参数名	类型	必填项	名称	描述
SourceLanguage	String	是	原语言	取值范围： zh：中文
TargetLanguage	String	是	翻译目标语言	取值范围： en：英文
DetextArea	String	否	设置字幕擦除	不填则不进行字幕擦除取值范围： Auto：自动识别擦除区域 [[x, y, width, height]]：指定擦除范围，格式为二层数组，可指定多个擦除区域，其中： x：字幕框左上角距离视频左上角的横向距离比例，取值范围：[0, 1] y：字幕框左上角距离视频左上角的竖向距离比例，取值范围：[0, 1] width：字幕框宽度相对于视频宽度的比例，取值范围：[0, 1] height：字幕框高度相对于视频高度的比例，取值范围：[0, 1]
SupportEditing	Boolean	否	是否支持二次编辑	取值范围： true：支持 false：不支持默认值：false
SubtitleTranslate	String	否	字幕级翻译配置	字幕级翻译配置填入此参数，则进行字幕级翻译，否则不进行字幕级翻译字符串符合 JSON 格式，详细入参介绍见下方
NeedSpeechTranslate	Boolean	否	是否需要声音翻译	取值范围： true：是 false：否默认值：false
SpeechTranslate	String	否	声音级翻译配置	字幕级翻译配置 NeedSpeechTranslate 为 true 或填入此参数时，则进行声音级翻译，否则不进行声音级翻译字符串符合 JSON 格式，详细入参介绍见下方

SubtitleTranslate

名称

类型

必填项

名称

描述

OcrArea

String

否

OCR 识别区域

不填默认为智能识别字幕区域
取值范围：

Auto：自动识别字幕区域
[x, y, width, height]：指定字幕区域，格式为单层数组，只能指定 1 个区域，其中：
- x：字幕框左上角距离视频左上角的横向距离比例，取值范围：[0, 1]
- y：字幕框左上角距离视频左上角的竖向距离比例，取值范围：[0, 1]
- width：字幕框宽度相对于视频宽度的比例，取值范围：[0, 1]
- height：字幕框高度相对于视频高度的比例，取值范围：[0, 1]

SubtitleConfig

String

否

字幕合成配置

用于自定义成片字幕效果，参数与剪辑合成中 Timeline 的 SubtitleTrackClip 中字幕参数一致，参考：Timeline配置说明

SpeechTranslate

名称	类型	必填项	名称	描述
SubtitleConfig	String	否	字幕合成配置	用于自定义成片字幕效果，参数与剪辑合成中 Timeline 的 SubtitleTrackClip 中字幕参数一致，参考：Timeline配置说明
OriginalJobId	String	否	原任务 Id	如果对翻译效果不满意，可以在 InputConfig.Subtitle 传入人工修改后的字幕文件，并且在此字段中传入原任务 Id 来重新生成翻译语音设置 SupportEditing 为 true 时（开启支持编辑），在任务结果中会包含 SpeechTranslationJobId，二次修正翻译时，将此值填入 OriginalJobId 中设置 SupportEditing 为 true 时（开启支持编辑），在任务结果中会包含会包含翻译后的字幕文件 SpeechTranslatedSubtitleURL，请在此文件内容的基础上进行修改，并在二次编辑时传入 InputConfig.Subtitle 中

场景示例

声音翻译 - 人工修正

背景说明

如果对声音翻译的结果不满意，可以通过人工修正字幕文件的方式，二次提交翻译进行修正。

流程描述

进行首次提交声音翻译（注意：如果需要后续支持人工修正，需要设置SupportEditing为true），完整参数示例如下：

{
    "InputConfig": {
        "Type": "Video",
        "Video": "*****a0052ff71efbfd4e7e6c66*****"
    },
    "OutputConfig": {
        "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/video.mp4"
    },
    "EditingConfig": {
        "SourceLanguage": "zh",
        "TargetLanguage": "en",
        "SupportEditing": true,
        "NeedSpeechTranslate": true
    }
}

首次提交声音翻译结果如下：

{
    "MediaId": "*****d306b6d71efbf98f6f7f55*****",
    "TranslatedAudioMediaId": "*****d306b6d71efbf98f6f7f5*****",
    "SpeechTranslatedSubtitleURL": "http://your-bucket.oss-cn-shanghai.aliyuncs.com/video_subtitle_asr_en.srt",
    "SpeechTranslationJobId": "*****74f329d4c03b63e7f7dac8*****"
}

其中：

MediaId：成片的媒资 Id；
TranslatedAudioMediaId：声音翻译得到的音频媒资 Id；
SpeechTranslatedSubtitleURL：声音翻译得到的字幕文件地址；
SpeechTranslationJobId：声音翻译的 JobId，人工修正时填入的 OriginalJobId 需要依赖此值。

如果对翻译效果不满意，请下载SpeechTranslatedSubtitleURL中的字幕文件，并对字幕文件中的内容进行修改，再次提交声音翻译，本次声音翻译会根据修改后的字幕内容进行重新生成音频。

重要

请仅针对 srt 文件中的文字内容信息进行修改，而不要修改字幕的时间或增加字幕条数。

二次修正时参数示例如下，主要包括原视频，修正后的字幕文件，原音频翻译任务 Id：

{
    "InputConfig": {
        "Type": "Video",
        "Video": "*****a0052ff71efbfd4e7e6c66*****",
        "Subtitle": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/new_subtitle.srt"
    },
    "OutputConfig": {
        "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/video.mp4"
    },
    "EditingConfig": {
        "SourceLanguage": "zh",
        "TargetLanguage": "en",
        "SupportEditing": true,
        "NeedSpeechTranslate": true,
        "SpeechTranslate": {
            "OriginalJobId": "*****b5d5d604916bb898b3066*****"
        }
    }
}