VideoProjectCreateToolTask - 创建工具任务--机器翻译-火山引擎

文档中心

机器翻译

任务管理

VideoProjectCreateToolTask - 创建工具任务

创建工具任务（字幕擦除/背景音处理）

使用说明

Post请求

注意事项

必须要工具项目下使用

请求参数

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

参数	类型	是否必填	示例值	描述
Action	String	是	VideoProjectCreateToolTask	要执行的操作，取值：VideoProjectCreateToolTask。
Version	String	是	2021-05-21	API的版本，取值：2021-05-21。
videoIDs	Array of String	否	["v1234zz", "v6789aa"]	要处理的视频的vid
projectId	String	是	12345	工具项目 id，创建工具任务的所属项目id，必须是工具项目
taskType	Integer	否	1	工具任务类型：任务类型： 1: Erase（字幕擦除） 2: Bgm（背景音处理）
toolParamsJson	String	否	{"AiRemoveType":1,"VideoInfos":[{"VideoID":"v0123","EpisodeNum":1},{"VideoID":"v0123","EpisodeNum":2}]}	任务参数序列化后的json字符串 VideoInfos: 视频信息，包含VideoID(视频vid)，EpisodeNum(集数) AiRemoveType:擦除任务需要传此字段，如果不传默认用2; 1是普通擦除，2是精细化擦除； BgmPolicy:去除背景音需要传此字段，如果不传默认用3 1 = NoMusic（消除音乐） 2 = NoAmbient（消除环境音） 3 = 两者都消除

返回参数

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

参数	类型	示例值	描述
data	Object	123	创建工具任务返回值

请求示例

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

{
  "projectId": "12345",
  "videoIDs": ["v123", "v456"],
  "taskType": 1,
  "toolParamsJson": "{\"AiRemoveType\":1,\"VideoID\":\"v01234\"}"
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20260527150646161065162220AE070F",
    "Action": "VideoProjectCreateToolTask",
    "Version": "2021-05-21",
    "Service": "i18n_openapi",
    "Region": "cn-beijing"
  },
  "Result": {
    "data": {
    	"taskId": "12341234"
    }
  }
}

错误码

您可访问公共错误码，获取更多错误码信息。

最近更新时间：2026.06.09 16:41:31

这个页面对您有帮助吗？

有用

无用

机器翻译

使用说明 #

注意事项 #

请求参数 #

返回参数 #

请求示例 #

返回示例 #