tencent cloud

文档反馈

查询指定的视频标签任务

最后更新时间: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 电话支持