tencent cloud

PrevNext

文档反馈

请输入关键字

Recent Pages

文档
对象存储
    文档

    查询指定的视频标签任务

    最后更新时间：2022-07-27 14:59:03

      功能描述

      DescribeMediaJob 接口用于查询指定的任务。

      请求

      请求示例

      GET /jobs/<jobId> HTTP/1.1
Host: <BucketName-APPID>.ci.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
      说明：

      • Authorization: Auth String（详情请参见 请求签名 文档）。
      • 通过子账号使用时，需要授予相关的权限，详情请参见授权粒度详情文档。

      请求头

      此接口仅使用公共请求头部，详情请参见 公共请求头部 文档。

      请求体

      该请求无请求体。

      响应

      响应头

      此接口仅返回公共响应头部，详情请参见 公共响应头部 文档。

      响应体

      该响应体返回为 application/xml 数据，包含完整节点数据的内容展示如下：

      <Response>
<JobsDetail>
</JobsDetail>
<NonExistJobIds></NonExistJobIds>
</Response>

      具体的数据内容如下：

      节点名称（关键字） 父节点 描述 类型
      Response 无 保存结果的容器 Container

      Container 节点 Response 的内容：

      节点名称（关键字） 父节点 描述 类型
      JobsDetail Response 任务的详细信息，同 CreateMediaJobs 接口的 Response.JobsDetail 节点 Container
      NonExistJobIds Response 查询的 ID 中不存在的任务，所有任务都存在时不返回 String

      Container 节点 Operation 的内容：

      节点名称（关键字） 父节点 描述 类型
      VideoTag Response.JobsDetail.Operation 同 CreateMediaJobs 接口中的 Request.Operation.VideoTag Container
      VideoTagResult Response.JobSDetail.Operation 在 job 的类型为 VideoTag 且状态为 success 时，返回视频标签任务结果详情 Container

      Container 节点 VideoTagResult 的内容：

      节点名称（关键字） 父节点 描述 类型
      StreamData Response.JobsDetail.Operation.VideoTagResult Stream 场景下视频标签任务的结果 Container

      Container 节点 StreamData 的内容：

      节点名称（关键字） 父节点 描述 类型
      Data Response.JobsDetail.Operation.VideoTagResult.StreamData Stream 场景视频标签任务的结果列表 Container
      SubErrCode Response.JobsDetail.Operation.VideoTagResult.StreamData 算法状态码，成功为0，非0异常 Container
      SubErrMsg Response.JobsDetail.Operation.VideoTagResult.StreamData 算法错误描述，成功为 ok , 不成功返回对应错误 Container

      Container 节点 Data 的内容：

      节点名称（关键字） 父节点 描述 类型
      Tags Response.JobsDetail.Operation.VideoTagResult.StreamData.Data 视频标签、视频分类信息 Container
      PersonTags Response.JobsDetail.Operation.VideoTagResult.StreamData.Data 人物标签信息 Container
      PlaceTags Response.JobsDetail.Operation.VideoTagResult.StreamData.Data 场景标签信息 Container
      ActionTags Response.JobsDetail.Operation.VideoTagResult.StreamData.Data 动作标签信息 Container
      ObjectTags Response.JobsDetail.Operation.VideoTagResult.StreamData.Data 物体标签信息 Container

      Container 节点 Tags （视频标签）的内容：

      节点名称（关键字） 父节点 描述 类型
      Tag Response.JobsDetail.Operation.VideoTagResult.StreamData.Data.Tags 标签名称 String
      TagCls Response.JobsDetail.Operation.VideoTagResult.StreamData.Data.Tags 标签分类名称 String
      Confidence Response.JobsDetail.Operation.VideoTagResult.StreamData.Data.Tags 标签模型预测分数，取值范围[0,1] Float

      Container 节点 Tags （视频分类）的内容：

      节点名称（关键字） 父节点 描述 类型
      Tag Response.JobsDetail.Operation.VideoTagResult.StreamData.Data.Tags 视频分类名称 String
      Confidence Response.JobsDetail.Operation.VideoTagResult.StreamData.Data.Tags 标签模型预测分数，取值范围[0,1] Float

      Container 节点 PersonTags 的内容：

      节点名称（关键字） 父节点 描述 类型
      Name Response.JobsDetail.Operation.VideoTagResult.StreamData.Data.PersonTags 人物名字 String
      Confidence Response.JobsDetail.Operation.VideoTagResult.StreamData.Data.PersonTags 标签模型预测分数 Float
      Count Response.JobsDetail.Operation.VideoTagResult.StreamData.Data.PersonTags 任务出现频次 String
      DetailPerSecond Response.JobsDetail.Operation.VideoTagResult.StreamData.Data.PersonTags 具体识别到人物出现的位置和时间信息 Container

      Container 节点 DetailPerSecond 的内容：

      节点名称（关键字） 父节点 描述 类型
      TimeStamp Response.JobsDetail.Operation.VideoTagResult.StreamData.Data.PersonTags.DetailPerSecond 出现时间，单位为秒 String
      Confidence Response.JobsDetail.Operation.VideoTagResult.StreamData.Data.PersonTags.DetailPerSecond 标签模型预测分数 Float
      BBox Response.JobsDetail.Operation.VideoTagResult.StreamData.Data.PersonTags.DetailPerSecond 左上角为原点，物体的相对坐标 Container

      Container 节点 BBox 的内容：

      节点名称（关键字） 父节点 描述 类型
      X1 Response.JobsDetail.Operation.VideoTagResult.StreamData.Data.PersonTags.DetailPerSecond.BBox 坐标X1的相对位置 String
      Y1 Response.JobsDetail.Operation.VideoTagResult.StreamData.Data.PersonTags.DetailPerSecond.BBox 坐标Y1的相对位置 String
      X2 Response.JobsDetail.Operation.VideoTagResult.StreamData.Data.PersonTags.DetailPerSecond.BBox 坐标X2的相对位置 String
      Y2 Response.JobsDetail.Operation.VideoTagResult.StreamData.Data.PersonTags.DetailPerSecond.BBox 坐标Y2的相对位置 String

      Container 节点 PlaceTags 的内容：

      节点名称（关键字） 父节点 描述 类型
      Tags Response.JobsDetail.Operation.VideoTagResult.StreamData.Data.PlaceTags 视频场景标签信息，可能不返回，内容同 Response.JobsDetail.Operation.VideoTagResult.StreamData.Data.Tags Container
      StartTime Response.JobsDetail.Operation.VideoTagResult.StreamData.Data.PlaceTags 片段起始时间，单位为秒 String
      EndTime Response.JobsDetail.Operation.VideoTagResult.StreamData.Data.PlaceTags 片段结束时间，单位为秒 String
      StartIndex Response.JobsDetail.Operation.VideoTagResult.StreamData.Data.PlaceTags 片段起始帧数 String
      EndIndex Response.JobsDetail.Operation.VideoTagResult.StreamData.Data.PlaceTags 片段结束帧数 String
      ClipFrameResult Response.JobsDetail.Operation.VideoTagResult.StreamData.Data.PlaceTags 单帧识别结果top1 String

      Container 节点 ActionTags 的内容：

      节点名称（关键字） 父节点 描述 类型
      Tags Response.JobsDetail.Operation.VideoTagResult.StreamData.Data.ActionTags 视频动作标签信息，可能不返回，内容同 Response.JobsDetail.Operation.VideoTagResult.StreamData.Data.Tags Container
      StartTime Response.JobsDetail.Operation.VideoTagResult.StreamData.Data.ActionTags 片段起始时间，单位为秒 String
      EndTime Response.JobsDetail.Operation.VideoTagResult.StreamData.Data.ActionTags 片段结束时间，单位为秒 String

      Container 节点 ObjectTags 的内容：

      节点名称（关键字） 父节点 描述 类型
      Objects Response.JobsDetail.Operation.VideoTagResult.StreamData.Data.ObjectTags 视频物体标签信息，可能不返回，内容同 Response.JobsDetail.Operation.VideoTagResult.StreamData.Data.Tags Container
      TimeStamp Response.JobsDetail.Operation.VideoTagResult.StreamData.Data.ObjectTags 识别物体时间戳，单位为秒 String

      Container 节点 Object 的内容：

      节点名称（关键字） 父节点 描述 类型
      Name Response.JobsDetail.Operation.VideoTagResult.StreamData.Data.ObjectTags.Objects 物体名称 Container
      Confidence Response.JobsDetail.Operation.VideoTagResult.StreamData.Data.ObjectTags.Objects 标签模型预测分数，取值范围[0,1] Float
      BBox Response.JobsDetail.Operation.VideoTagResult.StreamData.Data.ObjectTags.Objects 左上角为原点，物体的相对坐标, 内容同 Response.JobsDetail.Operation.VideoTagResult.StreamData.Data.PersonTags.DetailPerSecond.BBox Container

      错误码

      该请求操作无特殊错误信息，常见的错误信息请参见 错误码 文档。

      实际案例

      请求

      GET /jobs/jabcxxxxfeipplsdfwe HTTP/1.1
Accept: */*
Authorization:q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0**********&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=28e9a4986df11bed0255e97ff90500557e0ea057
Host:bucket-1250000000.ci.ap-beijing.myqcloud.com

      响应

      HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 666
Connection: keep-alive
Date: Thu, 15 Jun 2017 12:37:29 GMT
Server: tencent-ci
x-ci-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzhf****
<Response>
<JobsDetail>
  <Code>Success</Code>
  <Message>Success</Message>
  <JobId>jabcxxxxfeipplsdfwe</JobId>
  <State>Submitted</State>
  <CreationTime>2019-07-07T12:12:12+0800</CreationTime>
  <StartTime></StartTime>
  <EndTime></EndTime>
  <QueueId>p893bcda225bf4945a378da6662e81a89</QueueId>
  <Tag>VideoTag<Tag>
  <Input>
    <Object>test.mp4</Object>
  </Input>
  <Operation>
    <VideoTag>
      <Scenario>Stream</Scenario>
    </VideoTag>
    <VideoTagResult>
      <StreamData>
        <Data>
          <Tags>
            <Confidence>0.939035</Confidence>
            <Tag>自然风景</Tag>
            <TagCls>生活</TagCls>
          </Tags>
          <Tags>
            <Confidence>0.884062</Confidence>
            <Tag>雪山</Tag>
            <TagCls>旅行风景</TagCls>
          </Tags>
          <Tags>
            <Confidence>0.345798</Confidence>
            <Tag>云彩</Tag>
            <TagCls>旅行风景</TagCls>
          </Tags>
          <Tags>
            <Confidence>0.997328</Confidence>
            <Tag>自然风景</Tag>
          </Tags>
          <Tags>
            <Confidence>0.997595</Confidence>
            <Tag>旅行风景</Tag>
          </Tags>
          <PersonTags>
            <Name>韩雪</Name>
            <Confidence>0.985561</Confidence>
            <Count>3</Count>
            <DetailPerSecond>
              <TimeStamp>1</TimeStamp>
              <Confidence>0.8411815762519836</Confidence>
              <BBox>
                <X1>0.29050925925925924</X1>
                <Y1>0.257201646090535</Y1>
                <X2>0.4652777777777778</X2>
                <Y2>0.6584362139917695</Y2>
              </BBox>
            </DetailPerSecond>
            <DetailPerSecond>
              <TimeStamp>2</TimeStamp>
              <Confidence>0.9262690246105194</Confidence>
              <BBox>
                <X1>0.3472222222222222</X1>
                <Y1>0.03497942386831276</Y1>
                <X2>0.6412037037037037</X2>
                <Y2>0.7181069958847737</Y2>
              </BBox>
            </DetailPerSecond>
            <DetailPerSecond>
              <TimeStamp>3</TimeStamp>
              <Confidence>0.8933985382318497</Confidence>
              <BBox>
                <X1>0.3576388888888889</X1>
                <Y1>0.03497942386831276</Y1>
                <X2>0.6631944444444444</X2>
                <Y2>0.7366255144032922</Y2>
              </BBox>
            </DetailPerSecond>
          </PersonTags>
          <PersonTags>
            <Name>古力娜扎</Name>
            <Confidence>0.9010105729103088</Confidence>
            <Count>2</Count>
            <DetailPerSecond>
              <TimeStamp>18</TimeStamp>
              <Confidence>0.8933985382318497</Confidence>
              <BBox>
                <X1>0.5567129629629629</X1>
                <Y1>0.13991769547325103</Y1>
                <X2>0.8078703703703703</X2>
                <Y2>0.7469135802469136</Y2>
              </BBox>
            </DetailPerSecond>
            <DetailPerSecond>
              <TimeStamp>19</TimeStamp>
              <Confidence>0.8933985382318497</Confidence>
              <BBox>
                <X1>0.5335648148148148</X1>
                <Y1>0.21193415637860083</Y1>
                <X2>0.7800925925925926</X2>
                <Y2>0.8045267489711934</Y2>
              </BBox>
            </DetailPerSecond>              
          </PersonTags>
          <PlaceTags>
            <Tags>
              <Tag>森林</Tag>
              <TagCls>自然/户外</TagCls>
              <Confidence>0.516961</Confidence>
            </Tags>
            <Tags>
              <Tag>田野/公园/花园</Tag>
              <TagCls>自然/户外</TagCls>
              <Confidence>0.230019</Confidence>
            </Tags>
            <StartTime>0.0</StartTime>
            <EndTime>68.6</EndTime>
            <StartIndex>0</StartIndex>
            <EndIndex>1715</EndIndex>
            <ClipFrameResult>森林:0.37</ClipFrameResult>
            <ClipFrameResult>森林:0.22</ClipFrameResult>
            <ClipFrameResult>田野_公园_花园:0.19</ClipFrameResult>
            <ClipFrameResult>果园:0.14</ClipFrameResult>
          </PlaceTags>
          <PlaceTags>
            <StartTime>68.64</StartTime>
            <EndTime>72.4</EndTime>
            <StartIndex>1716</StartIndex>
            <EndIndex>1810</EndIndex>
            <ClipFrameResult>特写镜头:0.23</ClipFrameResult>
            <ClipFrameResult>冰川_冰山:0.04</ClipFrameResult>
            <ClipFrameResult>特写镜头:0.06</ClipFrameResult>
            <ClipFrameResult>特写镜头:0.09</ClipFrameResult>
          </PlaceTags>
          <ActionTags>
            <StartTime>5.8</StartTime>
            <EndTime>8.56</EndTime>
            <Tags>
              <Tag>说话</Tag>
              <TagCls>说话</TagCls>
              <Confidence>0.90646</Confidence>
            </Tags>
            <Tags>
              <Tag>敬酒</Tag>
              <TagCls>敬酒</TagCls>
              <Confidence>0.91610</Confidence>
            </Tags>
          </ActionTags>
          <ObjectTags>
            <TimeStamp>62.0</TimeStamp>
            <Objects>
              <Name>蛋糕</Name>
              <Confidence>0.638210</Confidence>
              <BBox>
                <X1>0.21793489158153534</X1>
                <Y1>0.5634896159172058</Y1>
                <X2>0.6121288537979126</X2>
                <Y2>1.0</Y2>
              </BBox>
            </Objects>
            <Objects>
              <Name>桌子</Name>
              <Confidence>0.67762</Confidence>
              <BBox>
                <X1>0.06269711256027222</X1>
                <Y1>0.6098541021347046</Y1>
                <X2>0.9128285646438599</X2>
                <Y2>0.9146066904067993</Y2>
              </BBox>
            </Objects>
          </ObjectTags>
        </Data>
        <SubErrCode>0</SubErrCode>
        <SubErrMsg>ok</SubErrMsg>
      </StreamData>
    </VideoTagResult>
  </Operation>
</JobsDetail>
</Response>
      联系我们

      联系我们，为您的业务提供专属服务。

      联系我们
      技术支持

      如果你想寻求进一步的帮助，通过工单与我们进行联络。我们提供7x24的工单服务。

      提交工单
      7x24 电话支持
      tencent
      Copyright © 2013-2022 Tencent Cloud. All Rights Reserved.
      隐私条款服务条款缓存条款