文档中心

机器翻译

任务管理

VideoProjectSerialDubTaskCreateFromTranslation - 根据翻译任务创建仅配音任务

根据已经完成的翻译任务创建一个对应语言的仅配音任务，直接使用翻译任务的总集数、原视频语言、目标视频语言

请求参数

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

参数	类型	是否必填	示例值	描述
Action	String	是	VideoProjectSerialDubTaskCreateFromTranslation	调用的接口名称，固定为： VideoProjectSerialDubTaskCreateFromTranslation
Version	String	是	2021-05-21	API 版本号，固定为：2021-05-21
projectId	String	是	"12345"	项目 id，创建任务的所属项目
taskIds	Array of String	是	["12345", "54321"]	翻译任务 ID 列表不允许重复，最多一次10个翻译任务；保证翻译任务已完成；同一项目id+任务id，在创建任务同时无法并发再次创建，直到第一个创建完成
taskName	String	否	"配音任务"	新配音任务的名称
aiRemoveType	Integer	否	0	aiRemoveType - 字幕擦除类型，默认0 0：无需擦除 1：普通擦除 2：精准擦除
dubVoiceMode	Integer	否	0	配音模式，默认0 0 表示高情感模式，真实还原原剧人声情绪，充满感染力 1 表示清晰模式，口音发音更加地道，声音更加清晰稳定
needVideoSpeed	boolean	否	false	视频倍速调整，默认false false: 关闭 true: 打开
bgmPolicy	Integer	否	0	是否保留情绪声（人唱歌、娇喘等声音）和背景声（环境声、打斗声）；默认都保留 0: 默认值，情绪声、背景声都保留 1: 不保留情绪声，只保留背景声 2: 不保留背景声，只保留情绪声 3: 都不保留
auditFailPolicy	Integer	否	0	视频安全审核失败的处理策略 0：终止整部剧 1：跳过失败集如果未填写，默认值 0
maxTargetSubtitleLines	Integer	否	3	最大的译文字幕行数，可选值为 1 ～ 4 的正整数（含 1 和 4），不填时默认为 3
suppressionParams	Object	否	{ "excludeSubtitle": false }	成片字幕压制策略 excludeSubtitle - 为true时不需要压制字幕，默认false
targetStyleMap	Object	否	{ en: "{\"fontSize\":11,\"textColor\":\"#000000\",\"textAlpha\":1,\"borderWidth\":\"\",\"backgroundColor\":\"#ffffff\",\"backgroundAlpha\":0,\"alignment\":0,\"x\":0,\"y\":-0.9,\"show\":true,\"fontFamily\":\"loki://98301255\"}" }	targetStyleMap - 字幕样式设置，key传目标语言代码，value 传 style 的JSON.stringify 结果，style 为 object 类型 fontSize: 表示设置字幕的字体大小，范围从 11 - 72，取整数即可；横屏推荐20，竖屏推荐11； fontFamily: 是字体族，取值可见https://docs.volcengine.com/docs/MachineTranslation/VideoProjectSerialDubTaskCreate-Createasingleshortdramadubbingtask?lang=zh#zzPDtDvA； x: 字幕水平坐标。-1.0 : 画面最左边缘; 0.0 : 画面水平中心; 1.0 : 画面最右边缘； y: 字幕垂直坐标。-1.0 : 画面最下边缘; 0.0 : 画面垂直中心; 1.0 : 画面最上边缘； alignment：文本对齐方式。0代表左对齐，1代表居中对齐，2代表右对齐，3代表上对齐，4代表下对齐； show: 是给前端译员端用的字段来控制在页面上是否展示的，可以直接传true；

返回参数

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

参数	类型	示例值	描述
data		{ results: [ { taskIds: ["123"], code: 0, dubTaskIds: ["456"], message: "" } ] }	创建任务的返回结果 results - 同一批次创建的仅配音任务在一个元素中会按照翻译任务所属的批次 + 目标语言，创建一个新的批次的对应目标语言的仅配音任务批次与翻译任务批次不同一个语言是一个任务具体字段 taskIds - 翻译任务的id code - 0代表创建成功 dubTaskIds - 创建成功的配音任务的id message - 创建失败的原因

错误结果

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

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

任务创建失败的具体含义

错误码	含义
211009	创建任务返回参数错误：翻译任务状态、项目归属、语种或素材校验失败；
211012	创建任务过程失败：重复并发建单触发锁冲突、返回的配音任务 ID 数量不完整；

最近更新时间：2026.10.16 16:21:25

这个页面对您有帮助吗？

有用

无用