调用ListImages接口获取媒体集中的图片列表,返回结果以图片加入媒体集的时间升序排序。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ListImages |
操作接口名称,系统规定参数,固定取值为ListImages。 |
CreateTimeStart | String | 是 | 2020-11-23T07:49:01.975Z |
图片创建时间的起始点,返回的图片均在此时间后加入媒体集。 |
Project | String | 是 | immimagetest |
项目名称。 |
SetId | String | 是 | set001 |
媒体集的唯一标识。 |
RegionId | String | 否 | cn-hangzhou |
项目所在地域的ID。 地域Endpoint格式为 |
Marker | String | 否 | image |
从Marker开始按字典序返回图片信息列表。如果不设置此参数,则从头开始返回图片。 |
Limit | Integer | 否 | 10 |
返回图片的最大数量,默认值为20,取值范围为1~100。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
NextMarker | String | CAESEgoQCg4KCkNyZWF0ZVRpbWUQABgBItcBCgkAIUv1J88rSRYKyQEDxAAAADFTMzEzNzM0MzYzNDM5MzUzODM1MzczNjMwMzIzNzM0MzUzYTY5NmQ2ZDY5NmQ2MTY3NjUzYTczNjU3NDMwMzAzMTNhMzc2NTY1NjM2NTMyMzQzNjYyMzUzMjM3MzgzODMwMzA2MzM4NjE2NDM4NjQ2MzY2NjE2MTMxNjMzNDMxNjY2MTY0MzEzODM0NjMzOTMzNjQ2MTM2MzUzMjY2NjYzMjMzNjUzNzM1NjUzNzM3MzM2MTY0MzEzMTM2MzYzMTM4Mzk= |
下一次列出图片信息时以此值为Marker,将未返回的结果返回。 当图片未全部返回时,此参数才有值。 |
Images | Array of Images |
图片信息列表。 |
|
Address | Struct |
图片地理位置检测结果。 只有图片中包含地理位置信息时,检测结果才有值。 |
|
AddressLine | String | 浙江省杭州市西湖区转塘街道石龙山西路 |
图片地理位置的完整地址。 |
City | String | 杭州市 |
图片地理位置所在城市(或同级)。 |
Country | String | 中国 |
图片地理位置所在国家或地区。 |
District | String | 西湖区 |
图片地理位置所在区(或同级)。 |
Province | String | 浙江省 |
图片地理位置所在省(或同级)。 |
Township | String | 转塘街道 |
图片地理位置所在街道(或同级)。 |
AddressFailReason | String | Timeout |
图片地理位置检测的失败原因。 只有当图片地理位置检测失败时,此参数才有值。 |
AddressModifyTime | String | 2020-11-25T10:12:59.57Z |
图片地理位置检测的更新时间。 |
AddressStatus | String | Success |
图片地理位置检测的状态,包括如下选项:
您可以根据该状态决定读取结果、等待或重试。 |
CreateTime | String | 2020-11-25T10:12:59.57Z |
图片加入媒体集的时间。 |
CroppingSuggestion | Array of CroppingSuggestion |
图片的裁减建议。 |
|
AspectRatio | String | 1:1 |
图片裁剪比例。 |
CroppingBoundary | Struct |
裁剪框信息。 |
|
Height | Integer | 200 |
裁剪框高度。单位为px。 |
Left | Integer | 10 |
顶点X坐标,距离左端距离。单位为px。 |
Top | Integer | 70 |
顶点Y坐标,距离顶端距离。单位为px。 |
Width | Integer | 200 |
裁剪框宽度。单位为px。 |
Score | Float | 0.8812195897102356 |
该裁剪方案的美学分数,分数越高表示该方案效果越好,取值范围为0~1。 |
CroppingSuggestionFailReason | String | Timeout |
裁剪建议提供失败的原因。 只有当图片裁剪建议提供失败时,此参数才有值。 |
CroppingSuggestionModifyTime | String | 2020-11-25T10:12:59.57Z |
提供最新裁剪建议的时间。 |
CroppingSuggestionStatus | String | NotProcessed |
提供裁剪建议的状态,包括如下选项:
您可以根据该状态决定读取结果、等待或重试。 |
Exif | String | {"FileSize":{"value":"29304"},"Format":{"value":"jpg"},"ImageHeight":{"value":"417"},"ImageWidth":{"value":"500"},"ResolutionUnit":{"value":"2"},"XResolution":{"value":"96/1"},"YResolution":{"value":"96/1"}} |
图片原始EXIF信息,以JSON Object序列化后的格式存储。 |
ExternalId | String | externalId001 |
外部ID,用于和您的应用层的ID(如果有)进行绑定。 |
Faces | Array of Faces |
人脸识别结果。 |
|
Age | Integer | 29 |
年龄。 |
Attractive | Float | 0.96 |
人脸吸引力,分数越高吸引力越强,取值范围为0~1。 |
Emotion | String | HAPPY |
心情。 |
EmotionConfidence | Float | 0.7079545259475708 |
心情置信度。 |
EmotionDetails | Struct |
七种心情对应的置信度。 |
|
ANGRY | Float | 0.00001282201901631197 |
ANGRY心情置信度。 |
CALM | Float | 0.2918718755245209 |
CALM心情置信度。 |
DISGUSTED | Float | 0.000033771051676012576 |
DISGUSTED心情置信度。 |
HAPPY | Float | 0.7079545259475708 |
HAPPY心情置信度。 |
SAD | Float | 0.00001527295717096422 |
SAD心情置信度。 |
SCARED | Float | 0.0000014976058082538657 |
SCARED心情置信度。 |
SURPRISED | Float | 0.00006676767952740192 |
SURPRISED心情置信度。 |
FaceAttributes | Struct |
人脸其他属性。 |
|
Beard | String | NONE |
是否有胡子。 |
BeardConfidence | Float | 1 |
是否有胡子置信度。 |
FaceBoundary | Struct |
人脸框信息。 |
|
Height | Integer | 252 |
人脸框高度。单位为px。 |
Left | Integer | 95 |
顶点X坐标,距离左端距离。单位为px。 |
Top | Integer | 191 |
顶点Y坐标,距离顶端距离。单位为px。 |
Width | Integer | 269 |
人脸框宽度。单位为px。 |
Glasses | String | NONE |
是否带眼镜。 |
GlassesConfidence | Float | 1 |
是否戴眼镜置信度。 |
HeadPose | Struct |
头部朝向。 |
|
Pitch | Float | 18.385589599609375 |
人脸的俯仰角,取值范围为 |
Roll | Float | 4.204030513763428 |
面内偏转角,取值范围为 |
Yaw | Float | 2.4945924282073975 |
人脸的左右偏转角,取值范围为 |
Mask | String | NONE |
是否带口罩。 |
MaskConfidence | Float | 1 |
是否带口罩置信度。 |
FaceConfidence | Float | 0.9608758687973022 |
人脸置信度。 |
FaceId | String | 59edc040d0a8f4952b183d1b5044913a0ccd8739500ee2705ffe4965a0406a51 |
人脸ID。 |
FaceQuality | Float | 0.9321779608726501 |
人脸质量。 |
Gender | String | MALE |
性别,可选项包括MALE和FEMALE。 |
GenderConfidence | Float | 1 |
性别置信度。 |
GroupId | String | group-not-grouped |
人脸分组ID。如果人脸未分组,则此参数返回值为group-not-grouped。 |
FacesFailReason | String | Timeout |
人脸识别的失败原因。 只有当人脸识别失败时,此参数才有值。 |
FacesModifyTime | String | 2020-11-25T10:12:59.57Z |
人脸识别的更新时间。 |
FacesStatus | String | Success |
人脸识别的状态,包括如下选项:
您可以根据该状态决定读取结果、等待或重试。 |
FileSize | Integer | 69732 |
文件大小,单位为字节。 |
ImageFormat | String | jpg |
图片格式。 |
ImageHeight | Integer | 861 |
图片高度。 |
ImageQuality | Struct |
图片质量分数。 |
|
Clarity | Float | 0.6101377010345459 |
当前版本不支持此参数。 图片清晰度。 |
ClarityScore | Float | 0.6101377010345459 |
当前版本不支持此参数。 图片清晰度的分数。 |
Color | Float | 0.6101377010345459 |
当前版本不支持此参数。 图片色度。 |
ColorScore | Float | 0.6101377010345459 |
当前版本不支持此参数。 图片色度的分数。 |
CompositionScore | Float | 0.6101377010345459 |
当前版本不支持此参数。 图片构成的分数。 |
Contrast | Float | 0.6101377010345459 |
当前版本不支持此参数。 图片对比度。 |
ContrastScore | Float | 0.6101377010345459 |
当前版本不支持此参数。 图片对比度的分数。 |
Exposure | Float | 0.6101377010345459 |
当前版本不支持此参数。 图片曝光程度。 |
ExposureScore | Float | 0.6101377010345459 |
当前版本不支持此参数。 图片曝光程度的分数。 |
OverallScore | Float | 0.7759467363357544 |
综合质量分数。 |
ImageQualityFailReason | String | Timeout |
图片质量打分的失败原因。 |
ImageQualityModifyTime | String | 2020-11-25T10:12:59.57Z |
图片质量打分的更新时间。 |
ImageQualityStatus | String | Success |
图片质量打分状态,包括如下选项:
您可以根据该状态决定读取结果、等待或重试。 |
ImageTime | String | 2020-11-25T10:12:59.57Z |
图片的拍摄日期,该日期从EXIF信息中获取。 如果图片EXIF信息无此信息,则返回结果中无此参数。 |
ImageUri | String | oss://imm-test/testcases/face1.jpg |
图片的OSS URI。 |
ImageWidth | Integer | 500 |
图片宽度。 |
Location | String | 30.134390,120.074997 |
图片地理位置,从EXIF信息中获取,格式为 如果图片EXIF信息无此信息,则返回结果中无此参数。 |
ModifyTime | String | 2020-11-25T10:12:59.57Z |
图片的修改时间。 添加图片后,如果未修改过图片,则图片的修改时间和图片的创建时间相同。 |
OCR | Array of OCR |
OCR识别结果。 |
|
OCRBoundary | Struct |
文字位置框信息。 |
|
Height | Integer | 12 |
文字位置框高度。单位为px。 |
Left | Integer | 12 |
顶点X坐标,距离左端距离。单位为px。 |
Top | Integer | 12 |
顶点Y坐标,距离顶端距离。单位为px。 |
Width | Integer | 12 |
文字位置框宽度。单位为px。 |
OCRConfidence | Float | 0.8254936695098877 |
文字置信度。 |
OCRContents | String | 欢迎使用智能媒体管理 |
文字内容。 |
OCRFailReason | String | Timeout |
OCR识别的失败原因。 |
OCRModifyTime | String | 2020-11-25T10:12:59.57Z |
OCR识别的更新时间。 |
OCRStatus | String | NotProcessed |
OCR识别的状态,包括如下选项:
您可以根据该状态决定读取结果、等待或重试。 |
Orientation | String | {"val":"Right-top","type":3} |
图片旋转值,从EXIF信息中获取。 如果图片EXIF信息无此信息,则返回结果中无此参数。 |
RemarksA | String | remarka |
标记信息列表。 |
RemarksArrayA | String | ["remarka1","remarka2"] |
标记信息列表。 |
RemarksArrayB | String | ["remarkb1","remarkb2"] |
标记信息列表。 |
RemarksB | String | remarkb |
标记信息。 |
RemarksC | String | remarkc |
标记信息。 |
RemarksD | String | remarkd |
标记信息。 |
SourcePosition | String | 00000000.010 |
只有当SourceType为video时,此参数才生效。 视频中该图片帧处于源视频的时间轴位置。格式为 |
SourceType | String | image |
源数据的类型。 |
SourceUri | String | oss://imm-test/testcases/face1.jpg |
图片OSS URI。 |
Tags | Array of Tags |
标签识别结果。 |
|
ParentTagName | String | 人物 |
父级标签名称。 |
TagConfidence | Float | 0.9812195897102356 |
标签置信度。 |
TagLevel | Integer | 1 |
标签级别,取值范围为1~4。 |
TagName | String | 脸 |
标签名称。 |
TagsFailReason | String | Timeout |
标签识别的失败原因。格式为 只有当标签识别失败时,此参数才有值。 |
TagsModifyTime | String | 2020-11-25T10:12:59.57Z |
标签识别的更新时间。当TagsStatus更改时更新。 |
TagsStatus | String | Success |
标签识别的状态,包括如下选项:
您可以根据该状态决定读取结果、等待或重试。 |
RequestId | String | A9C250B8-AC5B-4570-A7FE-73448DFCEFC8 |
当次请求的Request ID。 |
SetId | String | set001 |
媒体集的唯一标识。 |
示例
请求示例
http(s)://[Endpoint]/?Action=ListImages
&CreateTimeStart=2020-11-23T07:49:01.975Z
&Project=immimagetest
&SetId=set001
&<公共请求参数>
正常返回示例
XML
格式
<RequestId>A9C250B8-AC5B-4570-A7FE-73448DFCEFC8</RequestId>
<Images>
<ImageQuality>
<OverallScore>0.7759467363357544</OverallScore>
</ImageQuality>
<ModifyTime>2020-11-25T10:12:59.57Z</ModifyTime>
<Address>
<Township>转塘街道</Township>
<AddressLine>中国浙江省杭州市西湖区转塘街道石龙山西路</AddressLine>
<Country>中国</Country>
<City>杭州市</City>
<District>西湖区</District>
<Province>浙江省</Province>
</Address>
<SourceUri>oss://imm-test/testcases/face1.jpg</SourceUri>
<SourceType>image</SourceType>
<FacesFailReason/>
<CroppingSuggestionStatus>NotProcessed</CroppingSuggestionStatus>
<AddressFailReason/>
<RemarksA>remarka</RemarksA>
<AddressModifyTime>2020-11-25T10:12:59.57Z</AddressModifyTime>
<RemarksB>remarkb</RemarksB>
<ImageFormat>jpg</ImageFormat>
<RemarksArrayB>["remarkb1","remarkb2"]</RemarksArrayB>
<TagsFailReason/>
<Exif>{"FileSize":{"value":"29304"},"Format":{"value":"jpg"},"ImageHeight":{"value":"417"},"ImageWidth":{"value":"500"},"ResolutionUnit":{"value":"2"},"XResolution":{"value":"96/1"},"YResolution":{"value":"96/1"}}</Exif>
<FacesModifyTime>2020-11-25T10:12:59.57Z</FacesModifyTime>
<RemarksC>remarkc</RemarksC>
<RemarksD>remarkd</RemarksD>
<ImageWidth>500</ImageWidth>
<RemarksArrayA>["remarka1","remarka2"]</RemarksArrayA>
<Faces>
<FaceConfidence>0.9608758687973022</FaceConfidence>
<FaceId>59edc040d0a8f4952b183d1b5044913a0ccd8739500ee2705ffe4965a0406a51</FaceId>
<EmotionDetails>
<CALM>0.2918718755245209</CALM>
<SCARED>0.0000014976058082538657</SCARED>
<HAPPY>0.7079545259475708</HAPPY>
<SAD>0.00001527295717096422</SAD>
<SURPRISED>0.00006676767952740192</SURPRISED>
<ANGRY>0.00001282201901631197</ANGRY>
<DISGUSTED>0.000033771051676012576</DISGUSTED>
</EmotionDetails>
<Attractive>0.96</Attractive>
<FaceQuality>0.9321779608726501</FaceQuality>
<FaceAttributes>
<Beard>NONE</Beard>
<FaceBoundary>
<Left>95</Left>
<Top>191</Top>
<Height>252</Height>
<Width>269</Width>
</FaceBoundary>
<BeardConfidence>1</BeardConfidence>
<HeadPose>
<Pitch>18.385589599609375</Pitch>
<Roll>4.204030513763428</Roll>
<Yaw>2.4945924282073975</Yaw>
</HeadPose>
<Glasses>NONE</Glasses>
<MaskConfidence>1</MaskConfidence>
<Mask>NONE</Mask>
<GlassesConfidence>1</GlassesConfidence>
</FaceAttributes>
<GenderConfidence>1</GenderConfidence>
<EmotionConfidence>0.7079545259475708</EmotionConfidence>
<Gender>FEMALE</Gender>
<Emotion>HAPPY</Emotion>
<Age>29</Age>
<GroupId>group-not-grouped</GroupId>
</Faces>
<Tags>
<TagConfidence>0.9812195897102356</TagConfidence>
<TagName>脸</TagName>
<TagLevel>2</TagLevel>
<ParentTagName>人物</ParentTagName>
</Tags>
<Tags>
<TagConfidence>0.9812195897102356</TagConfidence>
<TagName>人物</TagName>
<TagLevel>1</TagLevel>
</Tags>
<Tags>
<TagConfidence>0.7626392841339111</TagConfidence>
<TagName>微笑</TagName>
<TagLevel>3</TagLevel>
<ParentTagName>日常行为</ParentTagName>
</Tags>
<Tags>
<TagConfidence>0.7626392841339111</TagConfidence>
<TagName>日常行为</TagName>
<TagLevel>2</TagLevel>
<ParentTagName>生活</ParentTagName>
</Tags>
<Tags>
<TagConfidence>0.7626392841339111</TagConfidence>
<TagName>生活</TagName>
<TagLevel>1</TagLevel>
</Tags>
<AddressStatus>Success</AddressStatus>
<FacesStatus>Success</FacesStatus>
<ImageQualityModifyTime>2020-11-25T10:12:59.57Z</ImageQualityModifyTime>
<ExternalId>externalId001</ExternalId>
<TagsModifyTime>2020-11-25T10:12:59.57Z</TagsModifyTime>
<CreateTime>2020-11-25T10:12:59.57Z</CreateTime>
<ImageQualityFailReason/>
<Orientation/>
<ImageUri>oss://imm-test/testcases/face1.jpg</ImageUri>
<OCRStatus>NotProcessed</OCRStatus>
<OCRModifyTime/>
<CroppingSuggestionModifyTime/>
<ImageQualityStatus>Success</ImageQualityStatus>
<TagsStatus>Success</TagsStatus>
<ImageHeight>861</ImageHeight>
<OCRFailReason/>
<Location>30.134390,120.074997</Location>
<FileSize>69732</FileSize>
</Images>
<NextMarker>CAESEgoQCg4KCkNyZWF0ZVRpbWUQABgBItcBCgkAIUv1J88rSRYKyQEDxAAAADFTMzEzNzM0MzYzNDM5MzUzODM1MzczNjMwMzIzNzM0MzUzYTY5NmQ2ZDY5NmQ2MTY3NjUzYTczNjU3NDMwMzAzMTNhMzc2NTY1NjM2NTMyMzQzNjYyMzUzMjM3MzgzODMwMzA2MzM4NjE2NDM4NjQ2MzY2NjE2MTMxNjMzNDMxNjY2MTY0MzEzODM0NjMzOTMzNjQ2MTM2MzUzMjY2NjYzMjMzNjUzNzM1NjUzNzM3MzM2MTY0MzEzMTM2MzYzMTM4Mzk=</NextMarker>
<SetId>set001</SetId>
JSON
格式
{
"RequestId": "A9C250B8-AC5B-4570-A7FE-73448DFCEFC8",
"Images": [
{
"ImageQuality": {
"OverallScore": "0.7759467363357544"
},
"ModifyTime": "2020-11-25T10:12:59.57Z",
"Address": {
"Township": "转塘街道",
"AddressLine": "中国浙江省杭州市西湖区转塘街道石龙山西路",
"Country": "中国",
"City": "杭州市",
"District": "西湖区",
"Province": "浙江省"
},
"SourceUri": "oss://imm-test/testcases/face1.jpg",
"SourceType": "image",
"FacesFailReason": "",
"CroppingSuggestionStatus": "NotProcessed",
"AddressFailReason": "",
"RemarksA": "remarka",
"AddressModifyTime": "2020-11-25T10:12:59.57Z",
"RemarksB": "remarkb",
"ImageFormat": "jpg",
"RemarksArrayB": "[\"remarkb1\",\"remarkb2\"]",
"TagsFailReason": "",
"Exif": "{\"FileSize\":{\"value\":\"29304\"},\"Format\":{\"value\":\"jpg\"},\"ImageHeight\":{\"value\":\"417\"},\"ImageWidth\":{\"value\":\"500\"},\"ResolutionUnit\":{\"value\":\"2\"},\"XResolution\":{\"value\":\"96/1\"},\"YResolution\":{\"value\":\"96/1\"}}",
"FacesModifyTime": "2020-11-25T10:12:59.57Z",
"RemarksC": "remarkc",
"RemarksD": "remarkd",
"ImageWidth": 500,
"RemarksArrayA": "[\"remarka1\",\"remarka2\"]",
"Faces": [
{
"FaceConfidence": "0.9608758687973022",
"FaceId": "59edc040d0a8f4952b183d1b5044913a0ccd8739500ee2705ffe4965a0406a51",
"EmotionDetails": {
"CALM": "0.2918718755245209",
"SCARED": "0.0000014976058082538657",
"HAPPY": "0.7079545259475708",
"SAD": "0.00001527295717096422",
"SURPRISED": "0.00006676767952740192",
"ANGRY": "0.00001282201901631197",
"DISGUSTED": "0.000033771051676012576"
},
"Attractive": 0.96,
"FaceQuality": "0.9321779608726501",
"FaceAttributes": {
"Beard": "NONE",
"FaceBoundary": {
"Left": 95,
"Top": 191,
"Height": 252,
"Width": 269
},
"BeardConfidence": 1,
"HeadPose": {
"Pitch": "18.385589599609375",
"Roll": "4.204030513763428",
"Yaw": "2.4945924282073975"
},
"Glasses": "NONE",
"MaskConfidence": 1,
"Mask": "NONE",
"GlassesConfidence": 1
},
"GenderConfidence": 1,
"EmotionConfidence": "0.7079545259475708",
"Gender": "FEMALE",
"Emotion": "HAPPY",
"Age": 29,
"GroupId": "group-not-grouped"
}
],
"Tags": [
{
"TagConfidence": "0.9812195897102356",
"TagName": "脸",
"TagLevel": 2,
"ParentTagName": "人物"
},
{
"TagConfidence": "0.9812195897102356",
"TagName": "人物",
"TagLevel": 1
},
{
"TagConfidence": "0.7626392841339111",
"TagName": "微笑",
"TagLevel": 3,
"ParentTagName": "日常行为"
},
{
"TagConfidence": "0.7626392841339111",
"TagName": "日常行为",
"TagLevel": 2,
"ParentTagName": "生活"
},
{
"TagConfidence": "0.7626392841339111",
"TagName": "生活",
"TagLevel": 1
}
],
"AddressStatus": "Success",
"FacesStatus": "Success",
"ImageQualityModifyTime": "2020-11-25T10:12:59.57Z",
"ExternalId": "externalId001",
"TagsModifyTime": "2020-11-25T10:12:59.57Z",
"CreateTime": "2020-11-25T10:12:59.57Z",
"ImageQualityFailReason": "",
"Orientation": "",
"ImageUri": "oss://imm-test/testcases/face1.jpg",
"OCRStatus": "NotProcessed",
"OCRModifyTime": "",
"CroppingSuggestionModifyTime": "",
"ImageQualityStatus": "Success",
"TagsStatus": "Success",
"ImageHeight": 861,
"OCRFailReason": "",
"Location": "30.134390,120.074997",
"FileSize": 69732
}
],
"NextMarker": "CAESEgoQCg4KCkNyZWF0ZVRpbWUQABgBItcBCgkAIUv1J88rSRYKyQEDxAAAADFTMzEzNzM0MzYzNDM5MzUzODM1MzczNjMwMzIzNzM0MzUzYTY5NmQ2ZDY5NmQ2MTY3NjUzYTczNjU3NDMwMzAzMTNhMzc2NTY1NjM2NTMyMzQzNjYyMzUzMjM3MzgzODMwMzA2MzM4NjE2NDM4NjQ2MzY2NjE2MTMxNjMzNDMxNjY2MTY0MzEzODM0NjMzOTMzNjQ2MTM2MzUzMjY2NjYzMjMzNjUzNzM1NjUzNzM3MzM2MTY0MzEzMTM2MzYzMTM4Mzk=",
"SetId": "set001"
}
在文档使用中是否遇到以下问题
更多建议
匿名提交