获取标准化接口任务结果

最近更新时间:2019-08-16 23:26:56

1. 接口描述

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

获取标准化接口任务结果

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

2. 输入参数

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

参数名称 必选 类型 描述
Action String 公共参数,本接口取值:DescribeAITaskResult
Version String 公共参数,本接口取值:2019-03-18
Region String 公共参数,本接口不需要传递此参数。
TaskId Integer 任务唯一标识符。在URL方式时提交请求后会返回一个任务标识符,后续查询该url的结果时使用这个标识符进行查询。
Limit Integer 限制数目
Offset Integer 偏移量

3. 输出参数

参数名称 类型 描述
AudioResult StandardAudioResult 音频分析结果
ImageResult StandardImageResult 图像分析结果
VideoResult StandardVideoResult 视频分析结果
Status String 任务状态
TaskId Integer 任务唯一id。在URL方式时提交请求后会返回一个jobid,后续查询该url的结果时使用这个jobid进行查询。
RequestId String 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 获取 AI 助教结果

获取 AI 助教分析后的结果

输入示例

https://tci.tencentcloudapi.com/?Action=DescribeAITaskResult
&TaskId=2516205217
&<公共请求参数>

输出示例

{
  "Response": {
    "TaskId": 2516205217,
    "RequestId": "885661be-0fc8-47c2-b1af-3ff1d6a54ecd",
    "ImageResult": {
      "Status": "",
      "Message": "",
      "TotalCount": 153,
      "ResultSet": [
        {
          "FaceIdentify": null,
          "FaceInfo": {
            "Left": 0,
            "Top": 0,
            "Width": 0,
            "Height": 0,
            "FrameWidth": 0,
            "FrameHeight": 0,
            "FaceRatio": 0
          },
          "FacePose": {
            "Direction": "frontal",
            "Yaw": -0.29673076,
            "Pitch": 9.21381,
            "Roll": -0.82792795
          },
          "FaceAttr": {
            "Sex": "female",
            "Age": 23
          },
          "FaceExpression": {
            "Expression": "neutral",
            "Confidence": 0.6842983
          },
          "HandTracking": null,
          "Gesture": null,
          "TeacherBodyMovement": null,
          "StudentBodyMovement": null,
          "Light": null,
          "TimeInfo": {
            "StartTs": 200,
            "EndTs": 200,
            "Duration": 0
          },
          "ActionInfo": null
        }
      ],
      "Statistic": {
        "FaceIdentify": [
          {
            "PersonId": "tci_person_1561445819427009841231",
            "Similarity": 0.9951723,
            "StartTs": 200,
            "EndTs": 4800,
            "Duration": 5600
          }
        ],
        "FaceExpression": [
          {
            "PersonId": "tci_person_1561445819427009841231",
            "ExpressRatio": [
              {
                "Express": "neutral",
                "Ratio": 0.80435,
                "Count": 37
              },
              {
                "Express": "surprise",
                "Ratio": 0.19565,
                "Count": 9
              }
            ]
          }
        ],
        "Handtracking": null,
        "Gesture": null,
        "TeacherMovement": null,
        "StudentMovement": null,
        "Light": null
      }
    },
    "VideoResult": {
      "Status": "",
      "Message": "",
      "HighlightsInfo": [
        {
          "HighlightsUrl": "http://videowonderful-1255701415.cos.ap-guangzhou.myqcloud.com/test/20190625_162809--ef_wonderful_20190625_162758_.mp4?sign=q-sign-algorithm%3Dsha1%26q-ak%3DAKIDEOuBIhv4wHI2ChdxFbnngLxbrzpUGo8H%26q-sign-time%3D1561451290%3B1561451590%26q-key-time%3D1561451290%3B1561451590%26q-header-list%3Dhost%26q-url-param-list%3D%26q-signature%3D154fba6daabaef5017849f6dd957cc8c67e3c8ed",
          "Smile": [
            {
              "StartTime": 2000,
              "EndTime": 17000
            }
          ],
          "Concentration": null,
          "PersonId": ""
        },
        {
          "HighlightsUrl": "http://videowonderful-1255701415.cos.ap-guangzhou.myqcloud.com/test/20190625_162818--ef_wonderful_20190625_162758_tci_person_1561445819427009841231.mp4?sign=q-sign-algorithm%3Dsha1%26q-ak%3DAKIDEOuBIhv4wHI2ChdxFbnngLxbrzpUGo8H%26q-sign-time%3D1561451299%3B1561451599%26q-key-time%3D1561451299%3B1561451599%26q-header-list%3Dhost%26q-url-param-list%3D%26q-signature%3Db2540e56515761565f11a9e608414a205d153c47",
          "Smile": [
            {
              "StartTime": 6000,
              "EndTime": 19000
            }
          ],
          "Concentration": null,
          "PersonId": "tci_person_1561445819427009841231"
        }
      ]
    },
    "AudioResult": {
      "Status": "",
      "Message": "",
      "TotalCount": 0,
      "Texts": [
        {
          "TextItem": {
            "Mbtm": 1790,
            "Metm": 7120,
            "Text": "He or she. ",
            "TextSize": 11,
            "Confidence": 0.030193144,
            "Tag": 0,
            "Words": [
              {
                "Mbtm": 2220,
                "Metm": 2660,
                "Text": "he",
                "Wsize": 2,
                "Confidence": 0
              },
              {
                "Mbtm": 2940,
                "Metm": 4180,
                "Text": "or",
                "Wsize": 2,
                "Confidence": 0
              },
              {
                "Mbtm": 4540,
                "Metm": 5240,
                "Text": "she",
                "Wsize": 3,
                "Confidence": 0
              }
            ]
          },
          "Speed": 0.750469,
          "MaxVolume": 0,
          "MinVolume": 0,
          "AvgVolume": 0
        }
      ],
      "VocabAnalysisDetailInfo": null,
      "AsrStat": {
        "TotalDuration": 19820,
        "SoundDuration": 8250,
        "MuteDuration": 11570,
        "VadNum": 3,
        "WordNum": 5,
        "AvgSpeed": 0.6060606,
        "MaxVolume": 0,
        "MinVolume": 0,
        "AvgVolume": 0
      },
      "VocabAnalysisStatInfo": null
    }
  }
}

5. 开发者资源

API Explorer

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

SDK

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

命令行工具

6. 错误码

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

错误码 描述
InternalError.StatusQueryFaceLibFailed 查询人脸库失败
InvalidParameter.StatusJobFailed 任务执行失败,请确保拉流地址稳定
InvalidParameter.StatusJobUnfinished 任务未完成
ResourceNotFound.HLJobIdNotFound 无法找到精彩集锦任务ID,请确认输入JobId无误。