单独创建一个短剧配音任务

请求参数

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

参数	类型	是否必填	示例值	描述
Action	String	是	VideoProjectSerialDubTaskCreate	调用的接口名称，固定为：VideoProjectSerialDubTaskCreate
Version	String	是	2021-05-21	API 版本号，固定为：2021-05-21
projectId	String	是		项目 id，创建任务的所属项目
taskInfo	Object	是	{ "taskName": "test_video_task", "serialNumber": 1, "sourceLang": "zh", "targetLangs": [ "en", "th" ], "aiRemoveType": 2, "isDub": true, "bgmPolicy": 0, "dubVoiceMode": 0, "suppressionParams": { "excludeSubtitle": false }, "needVideoSpeed": true, "maxTargetSubtitleLines": 3, "targetStyleMap": { en: "{\"fontSize\":11,\"textColor\":\"#000000\",\"textAlpha\":1,\"borderWidth\":\"\",\"backgroundColor\":\"#ffffff\",\"backgroundAlpha\":0,\"alignment\":0,\"x\":0,\"y\":-0.9,\"linePadding\":1,\"maxWidth\":1,\"fontFamily\":\"loki://98301255\"}" }, "sourceStyleMap": { en: "{\"fontSize\":11,\"textColor\":\"#000000\",\"textAlpha\":1,\"borderWidth\":\"\",\"backgroundColor\":\"#ffffff\",\"backgroundAlpha\":0,\"alignment\":0,\"x\":0,\"y\":-0.9,\"linePadding\":1,\"maxWidth\":1,\"fontFamily\":\"loki://98301255\"}" } "dubOrTranslationTaskID": "1234", "auditFailPolicy": 0 }	配音任务详细信息必填 taskName - 任务名称必填 serialNumber - 总集数必填 sourceLang - 原视频语言必填 targetLangs - 目标视频语言必填 isDub - 固定传 true aiRemoveType - 字幕擦除类型，默认0 0：无需擦除 1：普通擦除 2：精准擦除 bgmPolicy - 是否保留情绪声（人唱歌、娇喘等声音）和背景声（环境声、打斗声）；默认都保留 0: 默认值，情绪声、背景声都保留 1: 不保留情绪声，只保留背景声 2: 不保留背景声，只保留情绪声 3: 都不保留 dubVoiceMode - 配音模式，默认0 0 表示高情感模式，真实还原原剧人声情绪，充满感染力 1 表示清晰模式，口音发音更加地道，声音更加清晰稳定 suppressionParams - 成片字幕压制策略 excludeSubtitle - 为true时不需要压制字幕，默认false needVideoSpeed - 视频倍速调整 false: 关闭 true: 打开 maxTargetSubtitleLines - 最大的译文字幕行数，可选值为 1 ～ 4 的正整数（含 1 和 4），不填时默认为 3 targetStyleMap - 译文字幕样式设置，key传目标语言代码，value 传 style 的JSON.stringify 结果，style 为 object 类型 fontSize: 表示设置字幕的字体大小，范围从 11 - 72，取整数即可；横屏推荐20，竖屏推荐11； textColor: 文本颜色 textAlpha: 文本透明度, 取值范围：0-1 borderWidth: 文字描边的粗细，取值范围：0-1，不传为 0.05 borderColor: 文字描边的颜色，不传为 #000000 backgroundColor: 背景色 backgroundAlpha: 背景透明度，取值范围：0-1 alignment: 文本对齐方式，取值为 0: 左对齐 1: 居中 2: 右对齐 fontFamily: 表示字体族，完整字体可见：https://www.volcengine.com/docs/4640/2205648?lang=zh#zzPDtDvA x: 字幕水平坐标。-1.0 : 画面最左边缘; 0.0 : 画面水平中心; 1.0 : 画面最右边缘 y: 字幕垂直坐标。-1.0 : 画面最下边缘; 0.0 : 画面垂直中心; 1.0 : 画面最上边缘 linePadding: 字幕行间距，大于等于0的整数值，没有最大值； maxWidth: 字幕占屏幕宽度的比例，取值范围 (0, 1] sourceStyleMap：原文字幕样式，具体参数同 targetStyleMap dubOrTranslationTaskID - 要关联的翻译任务id 如果要从翻译任务中选择视频创建配音任务，需要先调用「查询短剧任务详情」接口获取到视频+字幕信息，再拼接成serialInfo字段 auditFailPolicy - 视频安全审核失败的处理策略 0：终止整部剧 1：跳过失败集如果未填写，默认值 0
serialInfo	Array of Object	是	[ { "episode": 1, "video": { "videoUrl":"https://xxxx/test_1.mp4", "name": "1.mp4" }, "subtitle": { "uri": "xxx", "name": "xxx字幕文件.srt", "fileType": 1, "subtitleLang": 1, "arrangement": 1, }, "subtitles": [ { "uri": "xxx", "name": "xxx字幕文件.srt", "fileType": 1, "targetLang": "en", "subtitleLang": 1, "arrangement": 1, } ] } ]	配音剧集信息列表，数组，每个元素描述一集的资源，包括以下信息必填 episode - 当前集数id 必填 video - 源视频 videoUrl：视频的链接，公网可访问 name：视频的名称，用 videoUrl 方式时，必填 vid：视频上传之后的vid，与videoUrl 传其中一个 pureVideo - 纯净视频 videoUrl：视频的链接，公网可访问 name：视频的名称，用 videoUrl 方式时，必填 vid：视频上传之后的vid，与videoUrl 传其中一个必填 subtitles - 对象数组译文字幕文件 uri：公网可访问的文件地址，与 subtitleId 传其中一个 subtitleId：字幕文件id，使用上传字幕接口获得，与 uri 传其中一个 name：字幕文件名称，用 uri 方式时，必填 fileType：字幕文件类型，1-srt 2-ass，用 uri 方式时，必填必填 targetLang：该译文文件的语种必填 subtitleLang：0双语 1原文 2译文 arrangement：字幕排列顺序（0：译文在上/前，1：原文在上/前），选填，如果是单语字幕则可以不填 subtitle - 原文字幕文件 uri：公网可访问的文件地址，与 subtitleId 传其中一个 subtitleId：字幕文件id，使用上传字幕接口获得，与 uri 传其中一个 name：字幕文件名称，用 uri 方式时，必填 fileType：字幕文件类型，1-srt 2-ass，用 uri 方式时，必填必填 subtitleLang：0双语 1原文 2译文 arrangement：字幕排列顺序（0：译文在上/前，1：原文在上/前），选填，如果是单语字幕则可以不填选填 effectSubtitles - 对象数组译文画面字幕文件 uri：公网可访问的文件地址 subtitleId：字幕文件id，使用上传字幕接口获得，与 uri 传其中一个 name：字幕文件名称，用 uri 方式时，必填 fileType：字幕文件类型，1-srt 2-ass，用 uri 方式时，必填必填 targetLang：该译文文件的语种必填 subtitleLang：0双语 1原文 2译文 arrangement：字幕排列顺序（0：译文在上/前，1：原文在上/前），选填，如果是单语字幕则可以不填 effectSubtitle - 原文画面字幕文件 uri：公网可访问的文件地址，与 subtitleId 传其中一个 subtitleId：字幕文件id，使用上传字幕接口获得，与 uri 传其中一个 name：字幕文件名称，用 uri 方式时，必填 fileType：字幕文件类型，1-srt 2-ass，用 uri 方式时，必填必填 subtitleLang：0双语 1原文 2译文 arrangement：字幕排列顺序（0：译文在上/前，1：原文在上/前），选填，如果是单语字幕则可以不填

字体族取值范围

字体名称	value	对应的id
Amita-Bold	amita_bold	loki://14444020
Eczar-SemiBold	eczar_semibold	loki://13897166
Harmattan-Regular	harmattan_regular	loki://14035806
Kurale-Regular	kurale_regular	loki://14449082
Martel Sans-Black	martelsans_black	loki://13891582
Martel Sans-Bold	martelsans_bold	loki://13891540
Martel Sans-ExtraBold	martelsans_extrabold	loki://13891048
Martel Sans-ExtraLight	martelsans_extralight	loki://13855100
Martel Sans-Light	martelsans_light	loki://13889692
Martel Sans-Regular	martelsans_regular	loki://13890920
Martel Sans-SemiBold	martelsans_semibold	loki://13889674
Mirza-Regular	mirza_regular	loki://14471318
Poppins-Regular	poppins_regular	loki://13853206
RozhaOne-Regular	rozhaone_regular	loki://14131940
SinkinSans-400Regular	sinkinsans_regular	loki://10608858
WixMadeforText-Rg	wixmadefortext_regular	loki://20853453
Arimo-VariableFont	arimo_variable	loki://98301255
Montserrat-Bold	montserrat_bold	loki://98604010
NotoSansKR-B	notosanskr_bold	loki://98659002
Sarabun	sarabun	loki://132212773
MinSans-Bold	minsans_bold	loki://98657494
NotoSans-Bold	notosans_bold	loki://135308526
NotoSans-Medium	notosans_medium	loki://220633655
Gen Shin Gothic P Bold	genshingothic_p_bold	loki://127504594
NotoSans-CJK	notosans_cjk	loki://228190238
Noto Serif-CJK	notoserif_cjk	loki://241348364
NotoSans-THai-Medium	notosans_thai_medium	loki://228190282
NotoSans-Arabic-Medium	notosans_arabic_medium	loki://228190477
NotoSans-Devanagari-Medium	notosans_devanagari_medium	loki://228190334

返回参数

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

参数	类型	示例值	描述
data		{ TaskIDs: ['12312','23432'], SubtitleFileCheckReports: [ { "EpisodeNum": "1", "SourceLanguage": "zh", "TargetLanguage": "en", "Issues": [ { "CheckPass": false, "Code": 211313, "Msg": "Error_211313" } ] } ] }	创建任务的返回结果 TaskIDs - 创建成功则返回任务ID 多个语种则会创建多个任务，返回顺序不一定按传入的语种顺序，建议创建后通过VideoProjectTaskDetail接口或登陆控制台再查询确认一遍任务id对应的语种 SubtitleFileCheckReports - 字幕文件校验失败的信息 EpisodeNum - 失败的集 SourceLanguage - 原视频语言 TargetLanguage - 目标语言 Issues - 存在的问题 CheckPass - 是否校验通过 Code - 错误码 Msg - 错误信息，参考下表的字幕文件错误含义

错误结果

参见返回结构中的错误结果，其中 Error 的情况如下：

参数	类型	示例值	描述
Error.Code	String	1001
Error.Message	String	配音目前不支持以下语种: xxx 视频数量必须和集数对应每一集的译文字幕文件数量必须和目标语种数量匹配其他错误信息	当创建失败时，会返回具体原因，本接口会校验以下问题目标语种是否在支持的配音语种范围内视频数量是否和总集数对应译文字幕文件数量是否和目标语种数量对应

字幕文件错误含义

错误码	含义
Error_211311	字幕文件缺失
Error_211312	字幕校验参数缺失
Error_211313	字幕文件无法解析，可能是文件不存在或者格式错误
Error_211314	字幕内容缺失
Error_211315	字幕时间大于视频时长
Error_211316	字幕时间小于0
Error_211317	字幕是双语字幕
Error_211318	字幕批量校验失败
Error_211331	缺少/无效的序列号
Error_211332	缺少时间轴
Error_211333	缺少字幕文本
Error_211334	时间轴错误
Error_211335	时间轴格式错误

机器翻译