请求参数

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

参数	类型	是否必填	示例值	描述
Action	String	是	VideoProjectAddTargetLangsToExistingDrama	要执行的操作，取值：VideoProjectAddTargetLangsToExistingDrama。
Version	String	是	2021-05-21	API的版本，取值：2021-05-21。
dramaId	String	是	"1231231"	指定的批次ID
fromTaskType	Integer	是	1	创建创建的任务来源。1 是翻译任务，4 是配音任务
projectId	String	是	"123123123"	项目ID
targetLanguages	Array of String	是	["zh"]	想要新增的目标语言
targetStyleMap	Object	否	{ "af": { 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" } }	译文字幕的样式信息，只有在纯 AI 翻译任务或者 AI 配音任务才生效
sourceStyleMap	Object	否	{ "af": { 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" } }	原文字幕的样式信息，只有在纯 AI 翻译任务或者 AI 配音任务才生效
videoIdentifiers	Array of Object	否	[ { "episodeNum": 1, "targetLang2Subtitle": [ { "targetLang": "en", "subtitleFileInfo": { "fileUrl": "https://xxxx", "fileName": "test.srt", "fileType": 1, "subtitleLang": 2 } } ] } ]	对应集数的字幕配置信息，只有在仅配音任务才生效。
isDub	Boolean	否	false	是否开启配音，仅在创建翻译任务 fromTaskType 为1 的时候生效
videoSpeedPolicy	Integer	否	1	是否开启视频时长动态调整，1 是开启。仅在创建翻译任务开启了配音，且指定批次中没有配音记录时生效，否则将复用指定批次的原有配置
bgmPolicy	Integer	否	0	是否保留情绪声和背景声，默认都保留。仅在创建翻译任务开启了配音，且指定批次中没有配音记录时生效，否则将复用指定批次的原有配置 0: 默认值，情绪声、背景声都保留 1: 不保留情绪声，只保留背景声 2: 不保留背景声，只保留情绪声 3: 都不保留
dubVoiceMode	Integer	否	1	配音模式，默认0 0 表示高情感模式，真实还原原剧人声情绪，充满感染力 1 表示清晰模式，口音发音更加地道，声音更加清晰稳定仅满足以下任一条件时生效：翻译模型选用高级版、创建翻译任务时同步开启配音，且该批次原任务未绑定配音任务当前操作为新建配音任务
deadline	String	否	"123123123123"	任务的截止时间，只在所选批次中的任务类型为 AIPE 的时候才生效
needTermValidation	Boolean	否	false	是否开启术语人工校对，默认false

返回参数

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

参数	类型	示例值	描述
data	Object	{ "dubTaskIDs"：["1231231"] }	返回创建的翻译任务或者配音任务的ID

请求示例

POST /?Action=VideoProjectAddTargetLangsToExistingDrama&Version=2021-05-21 HTTP/1.1
Host: https://open.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20260603T092635Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20260603/cn-beijing/i18n_openapi/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

{
  "dramaId": "7GOb",
  "fromTaskType": 668,
  "projectId": "YwRZB0ZDML",
  "targetLanguages": [
    "F3ng"
  ],
  "targetStyleMap": {},
  "videoIdentifiers": [
    {
      "episodeNum": 1,
      "videoId": "Mrkj0Ue",
      "videoName": "o9Zf7ZUcz",
      "targetLang2Subtitle": [
        {
          "targetLang": "en",
          "subtitleFileInfo": {
            "fileName": "5r8n8fV3kF3",
            "fileType": 499,
            "fileUrl": "OeB8eOz6iG",
            "subtitleLang": 301
          }
        }
      ]
    }
  ]
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "2026060317111420302919502827F1A8",
    "Action": "VideoProjectAddTargetLangsToExistingDrama",
    "Version": "2021-05-21",
    "Service": "i18n_openapi",
    "Region": "cn-beijing"
  },
  "Result": {
    "data": {
      "dubTaskIDs": [
        "123"
      ],
      "taskIDs": [
        "123"
      ]
    }
  }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	1001	Server Error	服务内部错误

最近更新时间：2026.10.23 10:43:02

这个页面对您有帮助吗？

有用

无用

机器翻译

请求参数 #

返回参数 #

请求示例 #

返回示例 #

错误码 #

请求参数

返回参数

请求示例

返回示例

错误码