调用ListVideoFrames接口获取一个视频的帧信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String ListVideoFrames

操作接口名称,固定取值为ListVideoFrames。

Project String immvideotest

项目名称。

SetId String Set-fc2ff7fb-b3b6-43a3-941d-5adae620d2ae

媒体集的唯一标识。

VideoUri String oss://imm-test/testcases/video1.mp4

视频的OSS URI。

OSS地址规则为oss://bucket/object,其中bucket为和当前项目处于同一区域的OSS Bucket名称,object为文件路径。

RegionId String cn-hangzhou

项目所在地域的ID。

地域Endpoint格式为imm.RegionId.aliyuncs.com,例如当RegionId为cn-hangzhou时,地域Endpoint为imm.cn-hangzhou.aliyuncs.com。

Marker String imm

从Marker开始按字典序返回视频帧信息列表。如果不设置此参数,则从头开始返回视频帧。

返回数据

名称 类型 示例值 描述
Frames Array of Frames

视频帧对应图片信息列表。

CreateTime String 2020-12-18T9:56:52.461Z

视频帧加入媒体集的时间。

Exif String { "FileSize": {"value": "165092"}, "Format": {"value": "jpg"}, "ImageHeight": {"value": "720"}, "ImageWidth": {"value": "1280"}, "ResolutionUnit": {"value": "1"}, "XResolution": {"value": "1/1"}, "YResolution": {"value": "1/1"}}

视频帧原始EXIF信息,以JSON Object序列化后的格式存储。

ExternalId String videoexternalId001

外部ID,用于和您的应用层的ID(如果有)进行绑定。

Faces Array of Faces

人脸识别结果。

Age Integer 39

年龄。

Attractive Float 0.7

人脸吸引力,分数越高吸引力越强,取值范围为0~1。

Emotion String CALM

心情。

EmotionConfidence Float 0.5385454297065735

心情置信度。

EmotionDetails Struct

七种心情对应的置信度。

ANGRY Float 0.003866414539515972

ANGRY心情置信度。

CALM Float 0.5385454297065735

CALM心情置信度。

DISGUSTED Float 0.00509241409599781

DISGUSTED心情置信度。

HAPPY Float 0.404163122177124

HAPPY心情置信度。

SAD Float 0.004653292708098888

SAD心情置信度。

SCARED Float 0.0040449220687150955

SCARED心情置信度。

SURPRISED Float 0.024903524667024612

SURPRISED心情置信度。

FaceAttributes Struct

人脸其他属性。

Beard String NONE

是否有胡子。

BeardConfidence Float 1

是否有胡子置信度。

FaceBoundary Struct

人脸框信息。

Height Integer 354

人脸框高度。单位为px。

Left Integer 487

顶点X坐标,距离左端距离。单位为px。

Top Integer 218

顶点Y坐标,距离顶端距离。单位为px。

Width Integer 354

人脸框宽度。单位为px。

Glasses String GLASSES

是否带眼镜。

GlassesConfidence Float 1

是否戴眼镜置信度。

HeadPose Struct

头部朝向。

Pitch Float 18.385589599609375

人脸的俯仰角,取值范围为-180~+180度,可信的范围建议为-30~+30度。

Roll Float 4.204030513763428

内偏转角,取值范围为-180~+180度,可信的建议范围为-45~+45度。

Yaw Float 2.4945924282073975

人脸的左右偏转角,取值范围为-180~+180度,可信的范围建议为-80~+80 度。

Mask String NONE

是否带口罩。

MaskConfidence Float 1

是否带口罩置信度。

FaceConfidence Float 0.9757006764411926

人脸置信度。

FaceId String d914660f02b43623ebcaa9d52a73fa94066eda736e76e248f60ee56d1c9e45d9

人脸ID。

FaceQuality Float 0.9321779608726501

人脸质量。

Gender String MAL1E

性别,可选项包括MALE和FEMALE。

GenderConfidence Float 1

性别置信度。

GroupId String group-not-grouped

人脸分组ID。如果人脸未分组,则此参数返回值为group-not-grouped。

FacesFailReason String Timeout

人脸识别的失败原因。

只有当人脸识别失败时,此参数才有值。

FacesModifyTime String 2020-12-18T10:56:52.461Z
FacesStatus String Success

人脸识别的状态,包括如下选项:

  • NotProcessed:未处理
  • Processing:处理中
  • Success:成功
  • Failed :失败

您可以根据该状态决定读取结果、等待或重试。

FileSize Integer 165092

文件大小,单位为字节。

ImageFormat String jpg

图片格式。

ImageHeight Integer 720

图片高度。

ImageTime String 2020-12-18T10:56:52.461Z

图片的拍摄日期,该日期从EXIF信息中获取。

如果图片EXIF信息无此信息,则返回结果中无此参数。

ImageUri String oss://imm-test/testcases/imgs/60.000.jpg

图片的OSS URI。

ImageWidth Integer 1280

图片宽度。

Location String 30.134390,120.074997

图片地理位置,从EXIF信息中获取,格式为lat,long,以英文逗号(,)分隔的浮点数。

如果图片EXIF信息无此信息,则返回结果中无此参数。

ModifyTime String 2020-12-18T10:56:52.461Z

图片的修改时间。

添加图片后,如果未修改过图片,则图片的修改时间和图片的创建时间相同。

OCR Array of OCR

OCR识别结果。

OCRBoundary Struct

文字位置框信息。

Height Integer 34

文字位置框高度。单位为px。

Left Integer 165

顶点X坐标,距离左端距离。单位为px。

Top Integer 20

顶点Y坐标,距离顶端距离。单位为px。

Width Integer 198

文字位置框宽度。单位为px。

OCRConfidence Float 0.954262

文字置信度。

OCRContents String DEPAFTMENT OF CORRECTONS

文字内容。

OCRFailReason String Timeout

OCR识别的失败原因。

OCRModifyTime String 2020-12-18T10:56:52.461Z

OCR识别的更新时间。

OCRStatus String Success

OCR识别的状态,包括如下选项:

  • NotProcessed:未处理
  • Processing:处理中
  • Success:成功
  • Failed :失败

您可以根据该状态决定读取结果、等待或重试。

Orientation String {"val":"Right-top","type":3}

图片旋转值,从EXIF信息中获取。

如果图片EXIF信息无此信息,则返回结果中无此参数。

RemarksA String remarka

标记信息。

RemarksB String remarkb

标记信息。

RemarksC String remarkc

标记信息。

RemarksD String remarkd

标记信息。

SourcePosition String 00000000.010

视频中该图片帧处于源视频的时间轴位置。格式为00000000.010,即%8.3f。

SourceType String video

源数据的类型。

SourceUri String oss://imm-test/testcases/video1.mp4

视频的OSS URI。

Tags Array of Tags

标签识别结果。

ParentTagName String 人物

父级标签名称。

TagConfidence Float 0.9812195897102356

标签置信度。

TagLevel Integer 2

标签级别,取值范围为1~4。

TagName String

标签名称。

TagsFailReason String Timeout

标签识别的失败原因。格式为[HTTPStatusCode ErrorCode] ErrorMessage,例如[400 InvalidResource] Specified resource is too large. Please check.

只有当标签识别失败时,此参数才有值。

TagsModifyTime String 2020-12-18T10:56:52.461Z

标签识别的更新时间。当TagsStatus更改时更新。

TagsStatus String Success

标签识别的状态,包括如下选项:

  • NotProcessed:未处理
  • Processing:处理中
  • Success:成功
  • Failed :失败

您可以根据该状态决定读取结果、等待或重试。

NextMarker String CAESEgoQCg4KCkNyZWF0ZVRpbWUQABgBItcBCgkAIUv1J88rSRYKyQEDxAAAADFTMzEzNzM0MzYzNDM5MzUzODM1MzczNjMwMzIzNzM0MzUzYTY5NmQ2ZDY5NmQ2MTY3NjUzYTczNjU3NDMwMzAzMTNhMzc2NTY1NjM2NTMyMzQzNjYyMzUzMjM3MzgzODMwMzA2MzM4NjE2NDM4NjQ2MzY2NjE2MTMxNjMzNDMxNjY2MTY0MzEzODM0NjMzOTMzNjQ2MTM2MzUzMjY2NjYzMjMzNjUzNzM1NjUzNzM3MzM2MTY0MzEzMTM2MzYzMTM4Mzk=

下一次列出视频帧信息时以此值为Marker,将未返回的结果返回。

RequestId String BE7D87A4-9F91-4EF6-96CA-4763063F34D1

当次请求的Request ID。

SetId String Set-fc2ff7fb-b3b6-43a3-941d-5adae620d2ae

媒体集的唯一标识。

VideoUri String oss://imm-test/testcases/video1.mp4

视频的OSS URI。

示例

请求示例

http(s)://[Endpoint]/?Action=ListVideoFrames
&Project=immvideotest
&SetId=Set-fc2ff7fb-b3b6-43a3-941d-5adae620d2ae
&VideoUri=oss://imm-test/testcases/video1.mp4
&<公共请求参数>

正常返回示例

XML格式

<RequestId>BE7D87A4-9F91-4EF6-96CA-4763063F34D1</RequestId>
<Frames>
    <OCRModifyTime>2020-12-18T10:56:52.461Z</OCRModifyTime>
    <FacesModifyTime>2020-12-18T10:56:52.461Z</FacesModifyTime>
    <OCR>
        <OCRContents>DEPAFTMENT OF CORRECTONS</OCRContents>
        <OCRConfidence>0.954262</OCRConfidence>
        <OCRBoundary>
            <Height>34</Height>
            <Width>198</Width>
            <Left>165</Left>
            <top>20</top>
        </OCRBoundary>
    </OCR>
    <OCR>
        <OCRContents>LBSNEWSCUM</OCRContents>
        <OCRConfidence>0.8219689</OCRConfidence>
        <OCRBoundary>
            <Height>18</Height>
            <Width>146</Width>
            <Left>966</Left>
            <top>20</top>
        </OCRBoundary>
    </OCR>
    <OCRStatus>Success</OCRStatus>
    <SourcePosition>00000000.010</SourcePosition>
    <Exif>{
    "FileSize": {"value": "165092"},
    "Format": {"value": "jpg"},
    "ImageHeight": {"value": "720"},
    "ImageWidth": {"value": "1280"},
    "ResolutionUnit": {"value": "1"},
    "XResolution": {"value": "1/1"},
    "YResolution": {"value": "1/1"}}</Exif>
    <ImageUri>oss://imm-test/testcases/imgs/60.000.jpg</ImageUri>
    <ImageWidth>1280</ImageWidth>
    <ImageFormat>jpg</ImageFormat>
    <SourceType>video</SourceType>
    <TagsModifyTime>2020-12-18T10:56:52.461Z</TagsModifyTime>
    <ModifyTime>2020-12-18T10:56:52.461Z</ModifyTime>
    <FileSize>165092</FileSize>
    <SourceUri>oss://imm-test/testcases/video1.mp4</SourceUri>
    <CreateTime>2020-12-18T9:56:52.461Z</CreateTime>
    <FacesStatus>Success</FacesStatus>
    <TagsStatus>Success</TagsStatus>
    <RemarksA/>
    <RemarksB/>
    <RemarksC/>
    <RemarksD/>
    <ExternalId/>
    <ImageHeight>720</ImageHeight>
</Frames>
<Frames>
    <OCRModifyTime>2020-12-18T10:56:52.461Z</OCRModifyTime>
    <FacesModifyTime>2020-12-18T10:56:52.461Z</FacesModifyTime>
    <OCR>
        <OCRContents>OCBS</OCRContents>
        <OCRConfidence>0.99335897</OCRConfidence>
        <OCRBoundary>
            <Height>51</Height>
            <Width>138</Width>
            <Left>971</Left>
            <top>20</top>
        </OCRBoundary>
    </OCR>
    <OCRStatus>Success</OCRStatus>
    <Faces>
        <Age>39</Age>
        <GenderConfidence>1</GenderConfidence>
        <Attractive>0.9</Attractive>
        <EmotionDetails>
            <SAD>0.004653292708098888</SAD>
            <SCARED>0.0040449220687150955</SCARED>
            <CALM>0.5385454297065735</CALM>
            <ANGRY>0.003866414539515972</ANGRY>
            <HAPPY>0.404163122177124</HAPPY>
            <DISGUSTED>0.00509241409599781</DISGUSTED>
            <SURPRISED>0.024903524667024612</SURPRISED>
        </EmotionDetails>
        <Gender>MALE</Gender>
        <FaceConfidence>0.9757006764411926</FaceConfidence>
        <EmotionConfidence>0.5385454297065735</EmotionConfidence>
        <Emotion>CALM</Emotion>
        <FaceId>d914660f02b43623ebcaa9d52a73fa94066eda736e76e248f60ee56d1c9e45d9</FaceId>
        <FaceAttributes>
            <Glasses>GLASSES</Glasses>
            <GlassesConfidence>1</GlassesConfidence>
            <Beard>NONE</Beard>
            <MaskConfidence>1</MaskConfidence>
            <HeadPose>
                <Pitch>18.385589599609375</Pitch>
                <Roll>4.204030513763428</Roll>
                <Yaw>2.4945924282073975</Yaw>
            </HeadPose>
            <BeardConfidence>1</BeardConfidence>
            <FaceBoundary>
                <Top>218</Top>
                <Height>354</Height>
                <Width>354</Width>
                <Left>487</Left>
            </FaceBoundary>
            <Mask>NONE</Mask>
        </FaceAttributes>
    </Faces>
    <SourcePosition>00000000.010</SourcePosition>
    <Exif>{
    "FileSize": {"value": "51867"},
    "Format": {"value": "jpg"},
    "ImageHeight": {"value": "720"},
    "ImageWidth": {"value": "1280"},
    "ResolutionUnit": {"value": "1"},
    "XResolution": {"value": "1/1"},
    "YResolution": {"value": "1/1"}}</Exif>
    <ImageUri>oss://imm-test/testcases/imgs/60.000.jpg</ImageUri>
    <ImageWidth>1280</ImageWidth>
    <ImageFormat>jpg</ImageFormat>
    <SourceType>video</SourceType>
    <TagsModifyTime>2020-12-18T10:56:52.461Z</TagsModifyTime>
    <ModifyTime>2020-12-18T10:56:52.461Z</ModifyTime>
    <FileSize>51867</FileSize>
    <SourceUri>oss://imm-test/testcases/video1.mp4</SourceUri>
    <CreateTime>2020-12-18T10:56:52.461Z</CreateTime>
    <FacesStatus>Success</FacesStatus>
    <TagsStatus>Success</TagsStatus>
    <RemarksA>remarka</RemarksA>
    <RemarksB>remarkb</RemarksB>
    <RemarksC>remarkc</RemarksC>
    <RemarksD>remarkd</RemarksD>
    <ExternalId>videoexternalId001</ExternalId>
    <ImageHeight>720</ImageHeight>
</Frames>
<VideoUri>oss://imm-test/testcases/video1.mp4</VideoUri>
<SetId>Set-fc2ff7fb-b3b6-43a3-941d-5adae620d2ae</SetId>
<NextMarker/>

JSON格式

{
  "RequestId": "BE7D87A4-9F91-4EF6-96CA-4763063F34D1",
  "Frames": [
    {
      "OCRModifyTime": "2020-12-18T10:56:52.461Z",
      "FacesModifyTime": "2020-12-18T10:56:52.461Z",
      "OCR": [
        {
          "OCRContents": "DEPAFTMENT OF CORRECTONS",
          "OCRConfidence": 0.954262,
          "OCRBoundary": {
            "Height": 34,
            "Width": 198,
            "Left": 165,
            "top": 20
          }
        },
        {
          "OCRContents": "LBSNEWSCUM",
          "OCRConfidence": 0.8219689,
          "OCRBoundary": {
            "Height": 18,
            "Width": 146,
            "Left": 966,
            "top": 20
          }
        }
      ],
      "OCRStatus": "Success",
      "Faces": [],
      "SourcePosition": "00000000.010",
      "Exif": "{\n    \"FileSize\": {\"value\": \"165092\"},\n    \"Format\": {\"value\": \"jpg\"},\n    \"ImageHeight\": {\"value\": \"720\"},\n    \"ImageWidth\": {\"value\": \"1280\"},\n    \"ResolutionUnit\": {\"value\": \"1\"},\n    \"XResolution\": {\"value\": \"1/1\"},\n    \"YResolution\": {\"value\": \"1/1\"}}",
      "ImageUri": "oss://imm-test/testcases/imgs/60.000.jpg",
      "ImageWidth": 1280,
      "ImageFormat": "jpg",
      "SourceType": "video",
      "TagsModifyTime": "2020-12-18T10:56:52.461Z",
      "ModifyTime": "2020-12-18T10:56:52.461Z",
      "FileSize": 165092,
      "Tags": [],
      "SourceUri": "oss://imm-test/testcases/video1.mp4",
      "CreateTime": "2020-12-18T9:56:52.461Z",
      "FacesStatus": "Success",
      "TagsStatus": "Success",
      "RemarksA": "",
      "RemarksB": "",
      "RemarksC": "",
      "RemarksD": "",
      "ExternalId": "",
      "ImageHeight": 720
    },
    {
      "OCRModifyTime": "2020-12-18T10:56:52.461Z",
      "FacesModifyTime": "2020-12-18T10:56:52.461Z",
      "OCR": [
        {
          "OCRContents": "OCBS",
          "OCRConfidence": 0.99335897,
          "OCRBoundary": {
            "Height": 51,
            "Width": 138,
            "Left": 971,
            "top": 20
          }
        }
      ],
      "OCRStatus": "Success",
      "Faces": [
        {
          "Age": 39,
          "GenderConfidence": 1,
          "Attractive": 0.9,
          "EmotionDetails": {
            "SAD": 0.004653292708098888,
            "SCARED": 0.0040449220687150955,
            "CALM": 0.5385454297065735,
            "ANGRY": 0.003866414539515972,
            "HAPPY": 0.404163122177124,
            "DISGUSTED": 0.00509241409599781,
            "SURPRISED": 0.024903524667024612
          },
          "Gender": "MALE",
          "FaceConfidence": 0.9757006764411926,
          "EmotionConfidence": 0.5385454297065735,
          "Emotion": "CALM",
          "FaceId": "d914660f02b43623ebcaa9d52a73fa94066eda736e76e248f60ee56d1c9e45d9",
          "FaceAttributes": {
            "Glasses": "GLASSES",
            "GlassesConfidence": 1,            
            "Beard": "NONE",            
            "MaskConfidence": 1,
            "HeadPose": {
							"Pitch": "18.385589599609375",
							"Roll": "4.204030513763428",
							"Yaw": "2.4945924282073975"
						},
            "BeardConfidence": 1,
            "FaceBoundary": {
              "Top": 218,
              "Height": 354,
              "Width": 354,
              "Left": 487
            },
            "Mask": "NONE"
          }
        }
      ],
      "SourcePosition": "00000000.010",
      "Exif": "{\n    \"FileSize\": {\"value\": \"51867\"},\n    \"Format\": {\"value\": \"jpg\"},\n    \"ImageHeight\": {\"value\": \"720\"},\n    \"ImageWidth\": {\"value\": \"1280\"},\n    \"ResolutionUnit\": {\"value\": \"1\"},\n    \"XResolution\": {\"value\": \"1/1\"},\n    \"YResolution\": {\"value\": \"1/1\"}}",
      "ImageUri": "oss://imm-test/testcases/imgs/60.000.jpg",
      "ImageWidth": 1280,
      "ImageFormat": "jpg",
      "SourceType": "video",
      "TagsModifyTime": "2020-12-18T10:56:52.461Z",
      "ModifyTime": "2020-12-18T10:56:52.461Z",
      "FileSize": 51867,
      "Tags": [],
      "SourceUri": "oss://imm-test/testcases/video1.mp4",
      "CreateTime": "2020-12-18T10:56:52.461Z",
      "FacesStatus": "Success",
      "TagsStatus": "Success",
      "RemarksA": "remarka",
      "RemarksB": "remarkb",
      "RemarksC": "remarkc",
      "RemarksD": "remarkd",
      "ExternalId": "videoexternalId001",
      "ImageHeight": 720
    }
  ],
  "VideoUri": "oss://imm-test/testcases/video1.mp4",
  "SetId": "Set-fc2ff7fb-b3b6-43a3-941d-5adae620d2ae",
  "NextMarker": ""
}