拉取任务详情

最近更新时间:2019-07-24 15:33:57

1. 接口描述

接口请求域名: tci.tencentcloudapi.com 。

拉取任务详情

默认接口请求频率限制:20次/秒。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数

参数名称 必选 类型 描述
Action String 公共参数,本接口取值:DescribeImageTask
Version String 公共参数,本接口取值:2019-03-18
Region String 公共参数,本接口不需要传递此参数。
JobId Integer 任务标识符
Limit Integer 限制数目
Offset Integer 偏移量

3. 输出参数

参数名称 类型 描述
ResultSet Array of ImageTaskResult 任务处理结果
JobId Integer 任务唯一标识
Progress Integer 任务执行进度
TotalCount Integer 任务结果数目
RequestId String 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 拉取任务详情

拉取任务详情

输入示例

https://tci.tencentcloudapi.com/?Action=DescribeImageTask
&JobId=task_xxx
&<公共请求参数>

输出示例

{
  "Response": {
    "RequestId": "ff1e1455-b2a9-4cdb-9387-30989c993c03",
    "JobId": 222,
    "Progress": 100,
    "TotalCount": 10,
    "ResultSet": [
      {
        "FaceIdentifyResult": null,
        "FaceInfoResult": null,
        "FacePoseResult": null,
        "FaceAttrResult": null,
        "FaceExpressionResult": null,
        "HandTrackingResult": null,
        "GestureResult": null,
        "TeacherBodyMovementResult": null,
        "StudentBodyMovementResult": null,
        "LightResult": {
          "LightValue": 131,
          "LightLevel": ""
        },
        "TimeInfoResult": {
          "StartTs": 104400,
          "EndTs": 104400,
          "Duration": 0
        }
      },
      {
        "FaceIdentifyResult": null,
        "FaceInfoResult": null,
        "FacePoseResult": null,
        "FaceAttrResult": null,
        "FaceExpressionResult": null,
        "HandTrackingResult": null,
        "GestureResult": null,
        "TeacherBodyMovementResult": null,
        "StudentBodyMovementResult": null,
        "LightResult": {
          "LightValue": 130,
          "LightLevel": ""
        },
        "TimeInfoResult": {
          "StartTs": 202500,
          "EndTs": 202500,
          "Duration": 0
        }
      },
      {
        "FaceIdentifyResult": null,
        "FaceInfoResult": null,
        "FacePoseResult": null,
        "FaceAttrResult": null,
        "FaceExpressionResult": null,
        "HandTrackingResult": null,
        "GestureResult": null,
        "TeacherBodyMovementResult": null,
        "StudentBodyMovementResult": null,
        "LightResult": {
          "LightValue": 130,
          "LightLevel": ""
        },
        "TimeInfoResult": {
          "StartTs": 298800,
          "EndTs": 298800,
          "Duration": 0
        }
      },
      {
        "FaceIdentifyResult": null,
        "FaceInfoResult": null,
        "FacePoseResult": null,
        "FaceAttrResult": null,
        "FaceExpressionResult": null,
        "HandTrackingResult": null,
        "GestureResult": null,
        "TeacherBodyMovementResult": null,
        "StudentBodyMovementResult": null,
        "LightResult": {
          "LightValue": 130,
          "LightLevel": ""
        },
        "TimeInfoResult": {
          "StartTs": 396000,
          "EndTs": 396000,
          "Duration": 0
        }
      },
      {
        "FaceIdentifyResult": null,
        "FaceInfoResult": null,
        "FacePoseResult": null,
        "FaceAttrResult": null,
        "FaceExpressionResult": null,
        "HandTrackingResult": null,
        "GestureResult": null,
        "TeacherBodyMovementResult": null,
        "StudentBodyMovementResult": null,
        "LightResult": {
          "LightValue": 127,
          "LightLevel": ""
        },
        "TimeInfoResult": {
          "StartTs": 495000,
          "EndTs": 495000,
          "Duration": 0
        }
      },
      {
        "FaceIdentifyResult": null,
        "FaceInfoResult": {
          "Left": 1138,
          "Top": 388,
          "Width": 156,
          "Height": 156,
          "FrameWidth": 1080,
          "FrameHeight": 1920,
          "FaceRatio": 21.293596
        },
        "FacePoseResult": {
          "Direction": "frontal",
          "Yaw": 7.2338576,
          "Pitch": -0.60113126,
          "Roll": 4.263466
        },
        "FaceAttrResult": {
          "Sex": "male",
          "Age": 24
        },
        "FaceExpressionResult": {
          "Expression": "neutral",
          "Confidence": 55
        },
        "HandTrackingResult": null,
        "GestureResult": null,
        "TeacherBodyMovementResult": null,
        "StudentBodyMovementResult": null,
        "LightResult": null,
        "TimeInfoResult": {
          "StartTs": 591300,
          "EndTs": 591300,
          "Duration": 0
        }
      },
      {
        "FaceIdentifyResult": null,
        "FaceInfoResult": null,
        "FacePoseResult": null,
        "FaceAttrResult": null,
        "FaceExpressionResult": null,
        "HandTrackingResult": null,
        "GestureResult": null,
        "TeacherBodyMovementResult": null,
        "StudentBodyMovementResult": null,
        "LightResult": {
          "LightValue": 124,
          "LightLevel": ""
        },
        "TimeInfoResult": {
          "StartTs": 591300,
          "EndTs": 591300,
          "Duration": 0
        }
      },
      {
        "FaceIdentifyResult": null,
        "FaceInfoResult": {
          "Left": 799,
          "Top": 410,
          "Width": 117,
          "Height": 117,
          "FrameWidth": 1080,
          "FrameHeight": 1920,
          "FaceRatio": 15.798129
        },
        "FacePoseResult": {
          "Direction": "frontal",
          "Yaw": 14.297856,
          "Pitch": 1.3801595,
          "Roll": -2.8457966
        },
        "FaceAttrResult": {
          "Sex": "male",
          "Age": 28
        },
        "FaceExpressionResult": {
          "Expression": "neutral",
          "Confidence": 99
        },
        "HandTrackingResult": null,
        "GestureResult": null,
        "TeacherBodyMovementResult": null,
        "StudentBodyMovementResult": null,
        "LightResult": null,
        "TimeInfoResult": {
          "StartTs": 687600,
          "EndTs": 687600,
          "Duration": 0
        }
      },
      {
        "FaceIdentifyResult": null,
        "FaceInfoResult": null,
        "FacePoseResult": null,
        "FaceAttrResult": null,
        "FaceExpressionResult": null,
        "HandTrackingResult": null,
        "GestureResult": null,
        "TeacherBodyMovementResult": null,
        "StudentBodyMovementResult": null,
        "LightResult": {
          "LightValue": 127,
          "LightLevel": ""
        },
        "TimeInfoResult": {
          "StartTs": 687600,
          "EndTs": 687600,
          "Duration": 0
        }
      },
      {
        "FaceIdentifyResult": null,
        "FaceInfoResult": {
          "Left": 875,
          "Top": 417,
          "Width": 209,
          "Height": 209,
          "FrameWidth": 1080,
          "FrameHeight": 1920,
          "FaceRatio": 17.596209
        },
        "FacePoseResult": {
          "Direction": "frontal",
          "Yaw": 12.399566,
          "Pitch": 2.138196,
          "Roll": 1.1387303
        },
        "FaceAttrResult": {
          "Sex": "male",
          "Age": 26
        },
        "FaceExpressionResult": {
          "Expression": "neutral",
          "Confidence": 99
        },
        "HandTrackingResult": null,
        "GestureResult": null,
        "TeacherBodyMovementResult": null,
        "StudentBodyMovementResult": null,
        "LightResult": null,
        "TimeInfoResult": {
          "StartTs": 785700,
          "EndTs": 785700,
          "Duration": 0
        }
      }
    ]
  }
}

5. 开发者资源

API Explorer

该工具提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力,能显著降低使用云 API 的难度,推荐使用。

SDK

云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。

命令行工具

6. 错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码

错误码 描述
InternalError 内部错误
InvalidParameter 参数错误
ResourceNotFound 资源不存在