调用本接口根据jobId查询异步任务详情。
接口说明
使用说明
本接口仅支持查询 6 个月内的异步任务数据。可查询的任务类型：转码任务，截图任务，AI 任务。
QPS 限制
本接口的单用户 QPS 限制为 15 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见 QPS 限制。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
vod:GetJobDetail |
get |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| JobId |
string |
是 |
任务 ID |
5c9dff***************59d50a967f5 |
| JobType |
string |
是 |
任务类型，取值：
|
transcode |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
请求唯一标识 |
6708D849-F109-1A6C-AC91-************ |
| JobType |
string |
任务类型 |
transcode |
| TranscodeJobDetail |
object |
转码任务详细信息，仅当 jobType 为 Transcode，该字段有值。 |
|
| JobId |
string |
任务 ID |
2dc1634e**********3f1d22d1a0174e |
| UserId |
integer |
发起该任务的用户 ID |
139109*****84930 |
| VideoId |
string |
媒资 ID |
30e5d7**********bd900764de7c0102 |
| Status |
string |
任务状态，取值：
|
TranscodeSuccess |
| TemplateId |
string |
模板 ID |
dbfaaec9e**********bf0b81219244c |
| Definition |
string |
清晰度 |
HD |
| CreateTime |
string |
任务创建时间，UTC 格式，YYYY-MM-DDTHH:MM:SSZ |
2024-10-14T07:39:25Z |
| CompleteTime |
string |
任务完成时间 |
2024-10-14T07:39:34Z |
| SnapshotJobDetail |
object |
截图任务详细信息，仅当 jobType 为 Snapshot，该字段有值 |
|
| JobId |
string |
任务 ID |
63df12s0**********4hdq249t82kr91 |
| UserId |
integer |
发起该任务的用户 ID |
139109*****84930 |
| VideoId |
string |
媒资 ID |
30e5d7**********bd900764de7c0102 |
| Status |
string |
任务状态，取值：
|
Success |
| Trigger |
string |
触发方式，取值：
|
Auto |
| NormalConfig |
string |
普通截图配置 |
{"inl":0,"num":32,"tm":5,"wd":"352","ft":"normal","hg":"640"} |
| SpriteConfig |
string |
雪碧图配置 |
{"pad":"0","lines":"10","mgin":"0","cols":"10","ikcp":"false","hg":"68"} |
| CreateTime |
string |
任务创建时间，UTC 格式，YYYY-MM-DDTHH:MM:SSZ |
2024-10-14T07:39:25Z |
| CompleteTime |
string |
任务完成时间 |
2024-10-14T07:39:45Z |
| AIJobDetail |
object |
AI 任务详细信息，仅当 TaskType 为 AI，该字段有值 |
|
| JobId |
string |
任务 ID |
5c9dff751ba**********59d50a967f5 |
| UserId |
integer |
发起该任务的用户 ID |
139109*****84930 |
| MediaId |
string |
媒资 ID |
30e5d7**********bd900764de7c0102 |
| JobType |
string |
AI 任务类型 |
AIVideoCensor |
| Status |
string |
任务状态，取值：
|
success |
| Trigger |
string |
触发方式，取值：
|
Auto |
| TemplateConfig |
string |
模板配置 |
{"AuditRange":["video","image-cover","text-title"],"AuditContent":["screen"],"AuditItem":["terrorism","porn"],"AuditAutoBlock":"no"} |
| CreateTime |
string |
任务创建时间，UTC 格式，YYYY-MM-DDTHH:MM:SSZ |
2024-10-14T07:39:25Z |
| CompleteTime |
string |
任务结束时间 |
2024-10-14T07:39:46Z |
| WorkflowTaskDetail |
object |
工作流任务详细信息，仅当 TaskType 为 Workflow，该字段有值 |
|
| TaskId |
string |
任务 ID |
46ecc024******92c8e26237e51 |
| Status |
string |
任务状态，取值：
|
Succeed |
| TaskInput |
string |
媒资信息 |
{\"Type\":\"Media\",\"Media\":\"00f985a50ae371f0ad1c4106e0ea0102\",\"Title\":\"2.mp4\",\"StorageLocation\":\"yiming-pre.oss-cn-shanghai.aliyuncs.com\"} |
| CreateTime |
string |
任务创建时间，UTC 格式，YYYY-MM-DDTHH:MM:SSZ |
2025-03-27T08:15:46Z |
| FinishTime |
string |
任务完成时间 |
2025-03-27T08:20:19Z |
| ActivityResults |
string |
工作流各节点处理结果，JSON 格式 |
{\"VodSnapshot_123\":{\"ActivityId\":\"VodSnapshot\",\"ActivityInstanceId\":\"c8cf62d53bef4e04bf703976bae6d0b9\",\"EndTime\":\"2025-03-27T08:15:51Z\",\"Result\":\"{\\\"RequestId\\\":\\\"8B3649AF-5A6B-1099-BEB6-164D81067398\\\",\\\"EventType\\\":\\\"SnapshotComplete\\\",\\\"UserId\\\":1797131669910763,\\\"MessageBody\\\":{\\\"Status\\\":\\\"success\\\",\\\"VideoId\\\":\\\"00f985a50ae371f0ad1c4106e0ea0102\\\",\\\"EventType\\\":\\\"SnapshotComplete\\\",\\\"EventTime\\\":\\\"2025-03-27T08:15:50Z\\\",\\\"TriggerSource\\\":\\\"{\\\\\\\"ActivityInstanceId\\\\\\\":\\\\\\\"c8cf62d53bef4e04bf703976bae6d0b9\\\\\\\",\\\\\\\"BizType\\\\\\\":\\\\\\\"ice-workflow\\\\\\\"}\\\"}}\",\"StartTime\":\"2025-03-27T08:15:47Z\",\"Status\":\"Succeed\"},\"Translate_zh_en\":{\"ActivityId\":\"VodTranslation\",\"ActivityInstanceId\":\"c043a872bb044763a3d293a5c2458b50\",\"EndTime\":\"2025-03-27T08:20:19Z\",\"Result\":\"{\\\"Type\\\":\\\"VideoTranslationAll\\\",\\\"Success\\\":false}\",\"StartTime\":\"2025-03-27T08:15:46Z\",\"Status\":\"Failed\"},\"Act_Start\":{\"ActivityId\":\"start\",\"ActivityInstanceId\":\"8a9402f4ff064084bf496707fb2d664a\",\"Result\":\"{\\\"Type\\\":\\\"Media\\\",\\\"bizType\\\":6,\\\"Media\\\":\\\"00f985a50ae371f0ad1c4106e0ea0102\\\",\\\"Title\\\":\\\"2.mp4\\\",\\\"taskInput\\\":\\\"{\\\\\\\"Type\\\\\\\":\\\\\\\"Media\\\\\\\",\\\\\\\"Media\\\\\\\":\\\\\\\"00f985a50ae371f0ad1c4106e0ea0102\\\\\\\"}\\\",\\\"userTaskInput\\\":\\\"{\\\\\\\"Type\\\\\\\":\\\\\\\"Media\\\\\\\",\\\\\\\"Media\\\\\\\":\\\\\\\"00f985a50ae371f0ad1c4106e0ea0102\\\\\\\",\\\\\\\"Title\\\\\\\":\\\\\\\"2.mp4\\\\\\\",\\\\\\\"StorageLocation\\\\\\\":\\\\\\\"yiming-pre.oss-cn-shanghai.aliyuncs.com\\\\\\\"}\\\",\\\"StorageLocation\\\":\\\"yiming-pre.oss-cn-shanghai.aliyuncs.com\\\",\\\"callerUid\\\":1797131669910763,\\\"CUR_NODE_NAME\\\":\\\"Act_Start\\\"}\",\"StartTime\":\"2025-03-27T08:15:45Z\",\"Status\":\"Succeed\"},\"VodDynamicImage_123\":{\"ActivityId\":\"VodDynamicImage\",\"ActivityInstanceId\":\"26e8dab82ab84110b1150f146caf633c\",\"EndTime\":\"2025-03-27T08:15:55Z\",\"Result\":\"{\\\"RequestId\\\":\\\"7120B5D5-430F-14AD-8922-577F072DDD64\\\",\\\"EventType\\\":\\\"DynamicImageComplete\\\",\\\"UserId\\\":1797131669910763,\\\"MessageBody\\\":{\\\"Status\\\":\\\"success\\\",\\\"VideoId\\\":\\\"00f985a50ae371f0ad1c4106e0ea0102\\\",\\\"EventType\\\":\\\"DynamicImageComplete\\\",\\\"EventTime\\\":\\\"2025-03-27T08:15:52Z\\\",\\\"TriggerSource\\\":\\\"{\\\\\\\"ActivityInstanceId\\\\\\\":\\\\\\\"26e8dab82ab84110b1150f146caf633c\\\\\\\",\\\\\\\"BizType\\\\\\\":\\\\\\\"ice-workflow\\\\\\\"}\\\"}}\",\"StartTime\":\"2025-03-27T08:15:47Z\",\"Status\":\"Succeed\"}} |
| UserData |
string |
自定义设置。为 JSON 字符串，支持消息回调、上传加速等设置。 |
{"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"*****","test":"www"}} |
| Workflow |
object |
工作流详情 |
|
| WorkflowId |
string |
工作流 ID |
vw_09d6*****b5c5b19a0c891e02 |
| Name |
string |
工作流名称 |
All_Activity_New_1_app-1000000 |
| Status |
string |
工作流状态，取值：
|
Active |
| Type |
string |
工作流种类，默认不填充 |
|
| CreateTime |
string |
工作流创建时间，UTC 格式，YYYY-MM-DDTHH:MM:SSZ |
2025-03-26T05:50:14Z |
| ModifiedTime |
string |
工作流修改时间 |
2025-03-26T07:51:55Z |
| AppId |
string |
应用 ID |
app-1000000 |
示例
正常返回示例
JSON格式
{
"RequestId": "6708D849-F109-1A6C-AC91-************",
"JobType": "transcode",
"TranscodeJobDetail": {
"JobId": "2dc1634e**********3f1d22d1a0174e",
"UserId": 0,
"VideoId": "30e5d7**********bd900764de7c0102",
"Status": "TranscodeSuccess",
"TemplateId": "dbfaaec9e**********bf0b81219244c",
"Definition": "HD",
"CreateTime": "2024-10-14T07:39:25Z",
"CompleteTime": "2024-10-14T07:39:34Z"
},
"SnapshotJobDetail": {
"JobId": "63df12s0**********4hdq249t82kr91",
"UserId": 0,
"VideoId": "30e5d7**********bd900764de7c0102",
"Status": "Success",
"Trigger": "Auto",
"NormalConfig": "{\"inl\":0,\"num\":32,\"tm\":5,\"wd\":\"352\",\"ft\":\"normal\",\"hg\":\"640\"}",
"SpriteConfig": "{\"pad\":\"0\",\"lines\":\"10\",\"mgin\":\"0\",\"cols\":\"10\",\"ikcp\":\"false\",\"hg\":\"68\"}",
"CreateTime": "2024-10-14T07:39:25Z",
"CompleteTime": "2024-10-14T07:39:45Z"
},
"AIJobDetail": {
"JobId": "5c9dff751ba**********59d50a967f5",
"UserId": 0,
"MediaId": "30e5d7**********bd900764de7c0102",
"JobType": "AIVideoCensor",
"Status": "success",
"Trigger": "Auto",
"TemplateConfig": "{\"AuditRange\":[\"video\",\"image-cover\",\"text-title\"],\"AuditContent\":[\"screen\"],\"AuditItem\":[\"terrorism\",\"porn\"],\"AuditAutoBlock\":\"no\"}",
"CreateTime": "2024-10-14T07:39:25Z",
"CompleteTime": "2024-10-14T07:39:46Z\n"
},
"WorkflowTaskDetail": {
"TaskId": "46ecc024******92c8e26237e51",
"Status": "Succeed",
"TaskInput": "{\\\"Type\\\":\\\"Media\\\",\\\"Media\\\":\\\"00f985a50ae371f0ad1c4106e0ea0102\\\",\\\"Title\\\":\\\"2.mp4\\\",\\\"StorageLocation\\\":\\\"yiming-pre.oss-cn-shanghai.aliyuncs.com\\\"}",
"CreateTime": "2025-03-27T08:15:46Z",
"FinishTime": "2025-03-27T08:20:19Z",
"ActivityResults": "{\\\"VodSnapshot_123\\\":{\\\"ActivityId\\\":\\\"VodSnapshot\\\",\\\"ActivityInstanceId\\\":\\\"c8cf62d53bef4e04bf703976bae6d0b9\\\",\\\"EndTime\\\":\\\"2025-03-27T08:15:51Z\\\",\\\"Result\\\":\\\"{\\\\\\\"RequestId\\\\\\\":\\\\\\\"8B3649AF-5A6B-1099-BEB6-164D81067398\\\\\\\",\\\\\\\"EventType\\\\\\\":\\\\\\\"SnapshotComplete\\\\\\\",\\\\\\\"UserId\\\\\\\":1797131669910763,\\\\\\\"MessageBody\\\\\\\":{\\\\\\\"Status\\\\\\\":\\\\\\\"success\\\\\\\",\\\\\\\"VideoId\\\\\\\":\\\\\\\"00f985a50ae371f0ad1c4106e0ea0102\\\\\\\",\\\\\\\"EventType\\\\\\\":\\\\\\\"SnapshotComplete\\\\\\\",\\\\\\\"EventTime\\\\\\\":\\\\\\\"2025-03-27T08:15:50Z\\\\\\\",\\\\\\\"TriggerSource\\\\\\\":\\\\\\\"{\\\\\\\\\\\\\\\"ActivityInstanceId\\\\\\\\\\\\\\\":\\\\\\\\\\\\\\\"c8cf62d53bef4e04bf703976bae6d0b9\\\\\\\\\\\\\\\",\\\\\\\\\\\\\\\"BizType\\\\\\\\\\\\\\\":\\\\\\\\\\\\\\\"ice-workflow\\\\\\\\\\\\\\\"}\\\\\\\"}}\\\",\\\"StartTime\\\":\\\"2025-03-27T08:15:47Z\\\",\\\"Status\\\":\\\"Succeed\\\"},\\\"Translate_zh_en\\\":{\\\"ActivityId\\\":\\\"VodTranslation\\\",\\\"ActivityInstanceId\\\":\\\"c043a872bb044763a3d293a5c2458b50\\\",\\\"EndTime\\\":\\\"2025-03-27T08:20:19Z\\\",\\\"Result\\\":\\\"{\\\\\\\"Type\\\\\\\":\\\\\\\"VideoTranslationAll\\\\\\\",\\\\\\\"Success\\\\\\\":false}\\\",\\\"StartTime\\\":\\\"2025-03-27T08:15:46Z\\\",\\\"Status\\\":\\\"Failed\\\"},\\\"Act_Start\\\":{\\\"ActivityId\\\":\\\"start\\\",\\\"ActivityInstanceId\\\":\\\"8a9402f4ff064084bf496707fb2d664a\\\",\\\"Result\\\":\\\"{\\\\\\\"Type\\\\\\\":\\\\\\\"Media\\\\\\\",\\\\\\\"bizType\\\\\\\":6,\\\\\\\"Media\\\\\\\":\\\\\\\"00f985a50ae371f0ad1c4106e0ea0102\\\\\\\",\\\\\\\"Title\\\\\\\":\\\\\\\"2.mp4\\\\\\\",\\\\\\\"taskInput\\\\\\\":\\\\\\\"{\\\\\\\\\\\\\\\"Type\\\\\\\\\\\\\\\":\\\\\\\\\\\\\\\"Media\\\\\\\\\\\\\\\",\\\\\\\\\\\\\\\"Media\\\\\\\\\\\\\\\":\\\\\\\\\\\\\\\"00f985a50ae371f0ad1c4106e0ea0102\\\\\\\\\\\\\\\"}\\\\\\\",\\\\\\\"userTaskInput\\\\\\\":\\\\\\\"{\\\\\\\\\\\\\\\"Type\\\\\\\\\\\\\\\":\\\\\\\\\\\\\\\"Media\\\\\\\\\\\\\\\",\\\\\\\\\\\\\\\"Media\\\\\\\\\\\\\\\":\\\\\\\\\\\\\\\"00f985a50ae371f0ad1c4106e0ea0102\\\\\\\\\\\\\\\",\\\\\\\\\\\\\\\"Title\\\\\\\\\\\\\\\":\\\\\\\\\\\\\\\"2.mp4\\\\\\\\\\\\\\\",\\\\\\\\\\\\\\\"StorageLocation\\\\\\\\\\\\\\\":\\\\\\\\\\\\\\\"yiming-pre.oss-cn-shanghai.aliyuncs.com\\\\\\\\\\\\\\\"}\\\\\\\",\\\\\\\"StorageLocation\\\\\\\":\\\\\\\"yiming-pre.oss-cn-shanghai.aliyuncs.com\\\\\\\",\\\\\\\"callerUid\\\\\\\":1797131669910763,\\\\\\\"CUR_NODE_NAME\\\\\\\":\\\\\\\"Act_Start\\\\\\\"}\\\",\\\"StartTime\\\":\\\"2025-03-27T08:15:45Z\\\",\\\"Status\\\":\\\"Succeed\\\"},\\\"VodDynamicImage_123\\\":{\\\"ActivityId\\\":\\\"VodDynamicImage\\\",\\\"ActivityInstanceId\\\":\\\"26e8dab82ab84110b1150f146caf633c\\\",\\\"EndTime\\\":\\\"2025-03-27T08:15:55Z\\\",\\\"Result\\\":\\\"{\\\\\\\"RequestId\\\\\\\":\\\\\\\"7120B5D5-430F-14AD-8922-577F072DDD64\\\\\\\",\\\\\\\"EventType\\\\\\\":\\\\\\\"DynamicImageComplete\\\\\\\",\\\\\\\"UserId\\\\\\\":1797131669910763,\\\\\\\"MessageBody\\\\\\\":{\\\\\\\"Status\\\\\\\":\\\\\\\"success\\\\\\\",\\\\\\\"VideoId\\\\\\\":\\\\\\\"00f985a50ae371f0ad1c4106e0ea0102\\\\\\\",\\\\\\\"EventType\\\\\\\":\\\\\\\"DynamicImageComplete\\\\\\\",\\\\\\\"EventTime\\\\\\\":\\\\\\\"2025-03-27T08:15:52Z\\\\\\\",\\\\\\\"TriggerSource\\\\\\\":\\\\\\\"{\\\\\\\\\\\\\\\"ActivityInstanceId\\\\\\\\\\\\\\\":\\\\\\\\\\\\\\\"26e8dab82ab84110b1150f146caf633c\\\\\\\\\\\\\\\",\\\\\\\\\\\\\\\"BizType\\\\\\\\\\\\\\\":\\\\\\\\\\\\\\\"ice-workflow\\\\\\\\\\\\\\\"}\\\\\\\"}}\\\",\\\"StartTime\\\":\\\"2025-03-27T08:15:47Z\\\",\\\"Status\\\":\\\"Succeed\\\"}}",
"UserData": "{\"MessageCallback\":{\"CallbackURL\":\"http://example.aliyundoc.com\"},\"Extend\":{\"localId\":\"*****\",\"test\":\"www\"}}",
"Workflow": {
"WorkflowId": "vw_09d6*****b5c5b19a0c891e02",
"Name": "All_Activity_New_1_app-1000000",
"Status": "Active",
"Type": "",
"CreateTime": "2025-03-26T05:50:14Z",
"ModifiedTime": "2025-03-26T07:51:55Z",
"AppId": "app-1000000"
}
}
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。