tencent cloud

文档反馈

批量拉取视频标签任务

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

    功能描述

    DescribeMediaJobs 接口用来拉取符合条件的任务。

    请求

    请求示例

    GET /jobs?size=&states=&queueId=&startCreationTime=&endCreationTime= HTTP/1.1
    Host: <BucketName-APPID>.ci.<Region>.myqcloud.com
    Date: <GMT Date>
    Authorization: <Auth String>
    
    说明:

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

    请求头

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

    请求体

    该请求无请求体。

    参数的具体内容如下:

    节点名称(关键字) 父节点 描述 类型 必选
    queueId 拉取该队列ID下的任务 String
    tag 任务的 Tag:VideoTag String
    orderByTime Desc 或者 Asc 。默认为 Desc String
    nextToken 请求的上下文,用于翻页。上次返回的值 String
    size 拉取的最大任务数。默认为10。最大为100 Integer
    states 拉取该状态的任务,以,分割,支持多状态:All,Submitted,Running,Success,Failed,Pause,Cancel 。默认为 All String
    startCreationTime 拉取创建时间大于该时间的任务。格式为:%Y-%m-%dT%H:%m:%S%z String
    endCreationTime 拉取创建时间小于该时间的任务。格式为:%Y-%m-%dT%H:%m:%S%z String

    响应

    响应头

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

    响应体

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

    <Response>
    <JobsDetail>
    </JobsDetail>
    <NextToken></NextToken>
    </Response>
    

    具体的数据内容如下:

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

    Container 节点 Response 的内容:

    节点名称(关键字) 父节点 描述 类型
    JobsDetail Response 任务的详细信息,同 DescibeMediaJob 接口中的 Response.JobsDetail 节点 Container
    NextToken Response 翻页的上下文 Token String

    错误码

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

    实际案例

    请求

    GET /jobs?queueId=aaaaaaaaaaa&tag=VideoTag HTTP/1.1
    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: NTk0MjdmODlfMjQ4OGY3XzYzYzhfMjc=
    <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 电话支持