VideoProjectTaskList - 获取短剧任务列表--机器翻译-火山引擎

文档中心

机器翻译

短剧任务管理

VideoProjectTaskList - 获取短剧任务列表

用于查询项目-获取视频任务列表

请求参数

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

参数	类型	是否必填	示例值	描述
Action	String	是	VideoProjectTaskList	要执行的操作，取值：VideoProjectTaskList。
Version	String	是	2021-05-21	API的版本，取值：2021-05-21。
taskTypes	String	否	1,2,3	任务类型，用逗号分隔开，比如"1,2,3"用来查看翻译视频、短剧以及标题翻译任务。 Enum { Default = 0, // 常规视频任务 Drama = 1, // 短剧 TitleAndDesc = 2, // 标题与简介翻译任务 Cover = 3, // 封面翻译任务 Dub = 4, // 配音任务 }
sourceLanguages	String	否	zh,en	查询任务的源语言，如有多个需要用逗号分隔。
projectId	String	是	27570220802	项目id
taskName	String	否	那年	任务名称，需要搜索具体任务时传入
taskIds	Array of String	否	28106724098	任务 id，如有多个需要用逗号分隔。
subtaskId	String	否	29063232514	子任务id，查询具体的子任务的数据
taskType	String	否	4	任务类型。需要查询配音任务列表时，固定传4 Enum { Default = 0, // 视频翻译任务 Drama = 1, // 短剧 TitleAndDesc = 2, // 标题与简介翻译任务 Cover = 3, // 封面翻译任务 Dub = 4, // 配音任务 }
status	String	否	Waiting = 0 Processing = 1 Finished = 2 Stopped = 3 Deleted = 4	任务状态
targetLanguages	String	否	en,fr,zh	查询条件里面的目标语言，如有多个需要用逗号分隔。
startTime	Integer	否	1764691200	开始时间戳，秒级
endTime	Integer	否	1765555199	结束时间戳，秒级
limit	Integer	否	20	分页请求每次请求的数量
offset	Integer	否	0	列表分页接口的翻页数量

返回参数

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

参数	类型	示例值	描述
data	Object	{ "totalCount": "1", "tasks": [ { "id": "27184633602", "projectId": "27178952194", "sourceVideos": "1", "deadline": "1764410400", "durationCount": "200", "wordsCount": "346", "notAllowDownloadSubtitles": true, "useVideoOcr": true, "translateOcrText": true, "textAiRemove": true, "episodeCount": "1", "name": "无权限_en", "sourceLanguage": "zh", "targetLanguages": [ "en" ], "workflowType": 0, "translatorType": 0, "status": 1, "creator": { "username": "caoyupeng.96", "avatar": "https://s1-imfile.feishucdn.com/static-resource/v1/v3_006i_ddccd319-8891-4d7d-b645-12c25b2b43ag~?image_size=240x240&cut_type=&quality=&format=png&sticker_format=.webp" }, "updater": "pipeline", "comment": "", "reference": "", "projectName": "无权限", "translationTeam": 0, "terminateRole": 0, "sourceStyle": "", "targetStyle": "", "taskType": 4, "dramaTaskWorkflow": 0, "createdAt": "2025-11-28T10:13:14.000Z", "updatedAt": "2025-11-28T11:31:30.000Z" } ], "allSourceLanguages": [ "zh" ], "allTargetLanguages": [ "en" ], "baseResp": { "statusMessage": "success", "statusCode": 0 } },	任务列表信息

请求示例

GET /?Action=VideoProjectTaskList&Version=2023-01-06&projectId=X9wUS2O HTTP/1.1
Host: open.volcengineapi.com
X-Date: 20260330T105116Z
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20260330/cn-beijing/i18n_openapi/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

返回示例

{
  "ResponseMetadata": {
    "RequestId": "202511112049050502001001378EE6ED",
    "Action": "VideoProjectTaskList",
    "Version": "2021-05-21",
    "Service": "i18n_openapi",
    "Region": "cn-beijing"
  },
	  "Result": {
			"data": {
	      "allSourceLanguages": [
	        "zh"
	      ],
	      "allTargetLanguages": [
	        "en"
	      ],
	      "totalCount": "10",
	      "tasks": [
	        {
	          "comment": "",
	          "createdAt": "2026-04-01T10:21:47.000Z",
	          "updatedAt": "2026-04-01T10:21:47.000Z",
	          "creator": {
	            "username": "username",
	            "avatar": "xx"
	          },
	          "id": "123456",
	          "name": "test",
	          "dramaTaskWorkflow": 0,
	          "projectName": "test",
	          "sourceLanguage": "zh",
	          "targetLanguages": [
	            "en"
	          ],
	          "taskType": 1,
	          "workflowType": 0,
	          "status": 2
	        }
	      ],
	      "total": 561
	    }
	  }
}

错误码

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

最近更新时间：2026.04.02 10:13:15

这个页面对您有帮助吗？

有用

无用

机器翻译

请求参数 #

返回参数 #

请求示例 #

返回示例 #

错误码 #

请求参数

返回参数

请求示例

返回示例

错误码