调用FindImages搜索媒体集中图片_智能媒体管理(IMM)-阿里云帮助中心

调用FindImages接口根据指定条件，例如时间、地点、标签、人物特征等，搜索媒体集中图片。并可以按照给定要求进行排序。

接口说明

此接口已不再维护，建议使用新版（2020-09-30 版本）查询与统计相关接口。关于新版与旧版 API 的对比，请参见新旧版本使用指引中的新版与旧版 API 对应关系说明章节。
搜索结果依赖索引的建立，返回结果与实际值可能有数秒的数据延迟。

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
imm:FindImages		全部资源 ``	无	无

请求参数

名称	类型	必填	描述	示例值
Project	string	是	项目名称。	immimagetest
SetId	string	是	媒体集的唯一标识。	set001
ImageSizeRange	string	是	图片大小范围，使用 JSON 格式表示，格式为`{"MinWidth":100,"MaxWidth":3000,"MinHeight":50,"MaxHeight":5000}`。	{"MinWidth":100,"MaxWidth":3000,"MinHeight":50,"MaxHeight":5000}
ImageTimeRange	string	否	图片的时间范围，该时间从 EXIF 信息获取，使用 JSON 格式表示，格式为 `{"Start":"1970-01-01T00:00:01.544Z","End":"2199-01-01T00:00:01.544Z"}`。	{"Start":"2020-11-10T00:00:01.544Z","End":"2020-11-25T00:00:01.544Z"}
CreateTimeRange	string	否	图片加入媒体集的时间范围，使用 JSON 格式表示，格式为`{"Start":"1970-01-01T00:00:01.544Z","End":"2199-01-01T00:00:01.544Z"}`。	{"Start":"2020-11-10T00:00:01.544Z","End":"2020-11-25T00:00:01.544Z"}
ModifyTimeRange	string	否	图片更新的时间范围，使用 JSON 格式表示，格式为 `{"Start":"1970-01-01T00:00:01.544Z","End":"2199-01-01T00:00:01.544Z"}`。	{"Start":"2020-11-10T00:00:01.544Z","End":"2020-11-25T00:00:01.544Z"}
SourceType	string	否	源数据的类型，包括如下选项： image：图片 video：视频	image
SourceUriPrefix	string	否	图片的 OSS URI 的前缀。	oss://imm-test/
RemarksAPrefix	string	否	标记信息的前缀，用于前缀匹配。	remark
RemarksBPrefix	string	否	标记信息的前缀，用于前缀匹配。	remark
TagNames	string	否	标签列表，设置多个标签时，请使用 JSON 格式表示，此时只有同时包含所有标签的图片才会返回，格式为["脸","人物"]。	["脸","人物"]
OCRContentsMatch	string	否	OCR 识别的内容搜索。	myh
AgeRange	string	否	年龄范围，使用 JSON 格式表示，格式为`{"Start":0,"End":99}`。	{"Start":0,"End":99}
Gender	string	否	性别，可选值为 MALE 和 FEMALE。	MALE
Emotion	string	否	表情，可选值为 HAPPY、SAD、ANGRY、SURPRISED、SCARED、DISGUSTED 和 CALM。	HAPPY
OrderBy	string	否	排序字段，可选值为 CreateTime、ModifyTime、ImageTime、FacesModifyTime、TagsModifyTime、RemarksA、RemarksB、RemarksC 和 RemarksD。	CreateTime
Order	string	否	排序方式，可选值为 ASC 和 DESC。 ASC：升序 DESC：降序	ASC
Marker	string	否	从 Marker 开始按字典序返回图片信息列表。如果不设置此参数，则从头开始返回图片。	imm
LocationBoundary	string	否	地理位置范围，使用 JSON 格式表示，格式为`{"TopLeft":"50.2,100.1","BottomRight":"30.5,120.1"}`。其中 TopLeft（左上）和 BottomRight（右下）两个顶点的格式为`lat,long`，是以英文逗号（,）分隔的浮点数。说明 Top 的值必须大于 Bottom 的值，Left 的值必须小于 Right 的值。	{"TopLeft":"50.2,100.1","BottomRight":"30.5,120.1"}
RemarksCPrefix	string	否	标记信息的前缀，用于前缀匹配。	remark
RemarksDPrefix	string	否	标记信息的前缀，用于前缀匹配。	remark
ExternalId	string	否	外部 ID，用于和您的应用层的 ID（如果有）进行绑定。	externalId001
GroupId	string	否	人脸分组 ID。如果人脸未分组，则此参数返回值为 group-not-grouped。	group-not-grouped
Limit	integer	否	返回图片的最大个数，默认值为 20，取值范围为 1~100。	20
FacesModifyTimeRange	string	否	人脸信息更新的时间范围，使用 JSON 格式表示，格式为`{"Start":"1970-01-01T00:00:01.544Z","End":"2199-01-01T00:00:01.544Z"}`。	{"Start":"2020-11-10T00:00:01.544Z","End":"2020-11-25T00:00:01.544Z"}
TagsModifyTimeRange	string	否	标签信息更新的时间范围，使用 JSON 格式表示，格式为`{"Start":"1970-01-01T00:00:01.544Z","End":"2199-01-01T00:00:01.544Z"}`。	{"Start":"2020-11-10T00:00:01.544Z","End":"2020-11-25T00:00:01.544Z"}
AddressLineContentsMatch	string	否	只有当 Location 有值，即带有地理信息标记的文件时，此参数才有效。地址搜索。	zhejiang
RemarksArrayAIn	string	否	只有图片的标签列表中存在至少一个标签匹配查询条件，则图片就会返回。	["remarka1","remarka2"]
RemarksArrayBIn	string	否	只有图片的标签列表中存在至少一个标签匹配查询条件，则图片就会返回。	["remarkb1","remarkb2"]

返回参数

名称	类型	描述	示例值
	object
RequestId	string	当次请求的 Request ID。	810FE908-522F-4951-8AF8-7211890D4B2A
Images	array<object>	图片信息列表。
Images	object
CroppingSuggestionStatus	string	提供裁剪建议的状态，包括如下选项： NotProcessed：未处理 Processing：处理中 Success：成功 Failed：失败您可以根据该状态决定读取结果、等待或重试。	NotProcessed
ImageQualityModifyTime	string	图片质量打分的更新时间。	2020-11-25T10:12:59.57Z
TagsFailReason	string	标签识别的失败原因。格式为`[HTTPStatusCode ErrorCode] ErrorMessage`，例如`[400 InvalidResource] Specified resource is too large. Please check.` 只有当标签识别失败时，此参数才有值。	Timeout
RemarksC	string	标记信息。	remarkc
CreateTime	string	图片加入媒体集的时间。	2020-11-25T10:12:59.57Z
SourceType	string	源数据的类型。	image
FacesFailReason	string	人脸识别的失败原因。只有当人脸识别失败时，此参数才有值。	Timeout
Tags	array<object>	标签识别结果。
Tags	object
TagConfidence	float	标签置信度。	0.9812195897102356
CentricScore	float	标签主体分数。用于提示该标签内容在图片中的主要程度，越高则说明该标签越可能为图片主体。取值范围为 0~1。	0
TagName	string	标签名称。	脸
TagLevel	integer	标签级别，取值范围为 1~4。	2
ParentTagName	string	父级标签名称。	人物
FacesModifyTime	string	人脸识别的更新时间。	2020-11-25T10:12:59.57Z
ImageTime	string	图片的拍摄日期，该日期从 EXIF 信息中获取。如果图片 EXIF 信息无此信息，则返回结果中无此参数。	2020-11-25T10:12:59.57Z
OCRModifyTime	string	OCR 识别的更新时间。	2020-11-25T10:12:59.57Z
AddressModifyTime	string	图片地理位置检测的更新时间。	2020-11-25T10:12:59.57Z
OCR	array<object>	OCR 识别结果。
OCR	object
OCRConfidence	float	文字置信度。	0.8254936695098877
OCRContents	string	文字内容。	欢迎使用智能媒体管理
OCRBoundary	object	文字位置框信息。
Top	integer	顶点 Y 坐标，距离顶端距离。	12
Width	integer	文字位置框宽度。单位为 px。	12
Height	integer	文字位置框高度。单位为 px。	12
Left	integer	顶点 X 坐标，距离左端距离。单位为 px。	12
ImageQualityFailReason	string	图片质量打分的失败原因。	Timeout
FacesStatus	string	人脸识别的状态，包括如下选项： NotProcessed：未处理 Processing：处理中 Success：成功 Failed：失败您可以根据该状态决定读取结果、等待或重试。	Success
ImageHeight	integer	图片高度。	861
RemarksArrayA	string	标记信息列表。	["remarka1","remarka2"]
Address	object	图片地理位置检测结果。只有图片带有地理位置信息时，检测结果才有值。
Township	string	图片地理位置所在街道（或同级）。	转塘街道
District	string	图片地理位置所在区（或同级）。	西湖区
AddressLine	string	图片地理位置的完整地址。	浙江省杭州市西湖区转塘街道石龙山西路
Country	string	图片地理位置所在国家或地区。	中国
City	string	图片地理位置所在城市（或同级）。	杭州市
Province	string	图片地理位置所在省（或同级）。	浙江省
ExternalId	string	外部 ID，用于和您的应用层的 ID（如果有）进行绑定。	externalId001
SourceUri	string	图片 OSS URI。	oss://imm-test/testcases/face1.jpg
ModifyTime	string	图片的修改时间。添加图片后，如果未修改过图片，则图片的修改时间和图片的创建时间相同。	2020-11-25T10:12:59.57Z
FileSize	integer	文件大小，单位为字节。	69732
SourcePosition	string	只有当 SourceType 为 video 时，此参数才生效。视频中该图片帧处于源视频的时间轴位置。格式为`00000000.010`，即%8.3f。	00000000.010
Faces	array<object>	人脸识别结果。
Faces	object
Gender	string	性别，可选项包括 MALE 和 FEMALE。	FEMALE
FaceId	string	人脸 ID。	59edc040d0a8f4952b183d1b5044913a0ccd8739500ee2705ffe4965a0406a51
GenderConfidence	float	性别置信度。	1
FaceAttributes	object	人脸其他属性。
GlassesConfidence	float	是否戴眼镜置信度。	1
Glasses	string	是否带眼镜。	NONE
Mask	string	是否带口罩。	NONE
BeardConfidence	float	是否有胡子置信度。	1
MaskConfidence	float	是否带口罩置信度。	1
FaceBoundary	object	人脸位置框信息。
Top	integer	顶点 Y 坐标，距离顶端距离。单位为 px。	152
Width	integer	人脸位置框宽度。单位为 px。	139
Height	integer	人脸位置框高度。单位为 px。	141
Left	integer	顶点 X 坐标，距离左端距离。单位为 px。	267
HeadPose	object	头部朝向。
Pitch	float	人脸的俯仰角，取值范围为`-180～+180`度，可信的范围建议为`-30～+30`度。	18.385589599609375
Roll	float	面内偏转角，取值范围为`-180～+180`度，可信的建议范围为`-45～+45`度。	4.204030513763428
Yaw	float	人脸的左右偏转角，取值范围为`-180～+180`度，可信的范围建议为`-80～+80`度。	2.4945924282073975
Beard	string	是否有胡子。	NONE
FaceQuality	float	人脸质量。	0.9321779608726501
Emotion	string	心情。	HAPPY
Age	integer	年龄。	29
FaceConfidence	float	人脸置信度。	0.9608758687973022
EmotionConfidence	float	心情置信度。	0.7079545259475708
Attractive	float	人脸吸引力，分数越高吸引力越强，取值范围为 0~1。	0.96
GroupId	string	人脸分组 ID。如果人脸未分组，则此参数返回值为 group-not-grouped。	group-not-grouped
EmotionDetails	object	七种心情对应的置信度。
HAPPY	float	HAPPY 心情置信度。	0.7079545259475708
SURPRISED	float	SURPRISED 心情置信度。	0.00006676767952740192
CALM	float	CALM 心情置信度。	0.2918718755245209
DISGUSTED	float	DISGUSTED 心情置信度。	0.000033771051676012576
ANGRY	float	ANGRY 心情置信度。	0.00001282201901631197
SAD	float	SAD 心情置信度。	0.00001527295717096422
SCARED	float	SCARED 心情置信度。	0.0000014976058082538657
ImageQualityStatus	string	图片质量打分状态，包括如下选项： NotProcessed：未处理 Processing：处理中 Success：成功 Failed：失败您可以根据该状态决定读取结果、等待或重试。	Success
OCRFailReason	string	OCR 识别的失败原因。	Timeout
AddressFailReason	string	图片地理位置检测的失败原因。只有当图片地理位置检测失败时，此参数才有值。	Timeout
ImageQuality	object	图片质量分数。
OverallScore	float	综合质量分数。	0.7759467363357544
Color	float	当前版本不支持此参数。图片色度。	0.6101377010345459
ColorScore	float	当前版本不支持此参数。图片色度的分数。	0.6101377010345459
ContrastScore	float	当前版本不支持此参数。图片对比度的分数。	0.6101377010345459
Contrast	float	当前版本不支持此参数。图片对比度。	0.6101377010345459
ExposureScore	float	当前版本不支持此参数。图片曝光程度的分数。	0.6101377010345459
ClarityScore	float	当前版本不支持此参数。图片清晰度的分数。	0.6101377010345459
Clarity	float	当前版本不支持此参数。图片清晰度。	0.6101377010345459
Exposure	float	当前版本不支持此参数。图片曝光程度。	0.6101377010345459
CompositionScore	float	当前版本不支持此参数。图片构成的分数。	0.6101377010345459
CroppingSuggestionModifyTime	string	提供最新裁剪建议的时间。	2020-11-25T10:12:59.57Z
ImageFormat	string	图片格式。	jpg
ImageWidth	integer	图片宽度。	500
RemarksArrayB	string	标记信息列表。	["remarkb1","remarkb2"]
CroppingSuggestion	array<object>	图片的裁减建议。
CroppingSuggestion	object
Score	float	该裁剪方案的美学分数，分数越高表示该方案效果越好，取值范围为 0～1。	0.8979608535766602
CroppingBoundary	object	裁剪框。
Top	integer	顶点 Y 坐标，距离顶端距离。单位为 px。	77
Width	integer	裁剪框宽度。单位为 px。	500
Height	integer	裁剪框高度。单位为 px。	499
Left	integer	顶点 X 坐标，距离左端距离。单位为 px。	0
AspectRatio	string	图片裁剪比例列表。	1:1
Orientation	string	图片旋转值，从 EXIF 信息中获取。如果图片 EXIF 信息无此信息，则返回结果中无此参数。	{"val":"Right-top","type":3}
RemarksD	string	标记信息。	remarkd
TagsStatus	string	标签识别的状态，包括如下选项： NotProcessed：未处理 Processing：处理中 Success：成功 Failed：失败您可以根据该状态决定读取结果、等待或重试。	Success
CroppingSuggestionFailReason	string	裁剪建议提供失败的原因。只有当图片裁剪建议提供失败时，此参数才有值。	Timeout
RemarksA	string	标记信息。	remarka
ImageUri	string	图片的 OSS URI。	oss://imm-test/testcases/face1.jpg
TagsModifyTime	string	标签识别的更新时间。当 TagsStatus 更改时更新。	2020-11-25T10:12:59.57Z
OCRStatus	string	OCR 识别的状态，包括如下选项： NotProcessed：未处理 Processing：处理中 Success：成功 Failed：失败您可以根据该状态决定读取结果、等待或重试。	NotProcessed
AddressStatus	string	图片地理位置检测的状态，包括如下选项： NotProcessed：未处理 Processing：处理中 Success：成功 Failed：失败您可以根据该状态决定读取结果、等待或重试。	Success
Exif	string	图片原始 EXIF 信息，以 JSON Object 序列化后的格式存储。	{"FileSize":{"value":"29304"},"Format":{"value":"jpg"},"ImageHeight":{"value":"417"},"ImageWidth":{"value":"500"},"ResolutionUnit":{"value":"2"},"XResolution":{"value":"96/1"},"YResolution":{"value":"96/1"}}
Location	string	图片地理位置，从 EXIF 信息中获取，格式为`lat,long`，以英文逗号（,）分隔的浮点数。如果图片 EXIF 信息无此信息，则返回结果中无此参数。	30.134390,120.074997
RemarksB	string	标记信息。	remarkb
NextMarker	string	下一次列出图片信息时以此值为 Marker，将未返回的结果返回。当图片未全部返回时，此参数才有值。	CAESBgoEIgIIABgAIswBCskBA8QAAAAxUzMxMzczNDM2MzQzOTM1MzgzNTM3MzYzMDMyMzczNDM1M2E2OTZkNmQ2OTZkNjE2NzY1M2E3MzY1NzQzMDMwMzEzYTMxMzYzMzM1NjIzOTMzMzI2MTYyMzQzNzY2NjMzNjY2NjI2MTYxMzMzMjM1MzQzOTMzMzQzNzMwMzI2NTMxNjE2MjM3MzczMTY0NjM2NDM2MzgzNjM4NjQzMjM2MzEzNzM2MzYzNjM4NjUzNTYyMzc2NjM0MzU2MjYxNjE2NTMx
SetId	string	媒体集的唯一标识。	set001

示例

正常返回示例

JSON格式

{
  "RequestId": "810FE908-522F-4951-8AF8-7211890D4B2A",
  "Images": [
    {
      "CroppingSuggestionStatus": "NotProcessed",
      "ImageQualityModifyTime": "2020-11-25T10:12:59.57Z",
      "TagsFailReason": "Timeout",
      "RemarksC": "remarkc",
      "CreateTime": "2020-11-25T10:12:59.57Z",
      "SourceType": "image",
      "FacesFailReason": "Timeout",
      "Tags": [
        {
          "TagConfidence": 0.9812195897102356,
          "CentricScore": 0,
          "TagName": "脸",
          "TagLevel": 2,
          "ParentTagName": "人物"
        }
      ],
      "FacesModifyTime": "2020-11-25T10:12:59.57Z",
      "ImageTime": "2020-11-25T10:12:59.57Z",
      "OCRModifyTime": "2020-11-25T10:12:59.57Z",
      "AddressModifyTime": "2020-11-25T10:12:59.57Z",
      "OCR": [
        {
          "OCRConfidence": 0.8254936695098877,
          "OCRContents": "欢迎使用智能媒体管理",
          "OCRBoundary": {
            "Top": 12,
            "Width": 12,
            "Height": 12,
            "Left": 12
          }
        }
      ],
      "ImageQualityFailReason": "Timeout",
      "FacesStatus": "Success",
      "ImageHeight": 861,
      "RemarksArrayA": "[\"remarka1\",\"remarka2\"]",
      "Address": {
        "Township": "转塘街道",
        "District": "西湖区",
        "AddressLine": "浙江省杭州市西湖区转塘街道石龙山西路",
        "Country": "中国",
        "City": "杭州市",
        "Province": "浙江省"
      },
      "ExternalId": "externalId001",
      "SourceUri": "oss://imm-test/testcases/face1.jpg",
      "ModifyTime": "2020-11-25T10:12:59.57Z",
      "FileSize": 69732,
      "SourcePosition": "00000000.010",
      "Faces": [
        {
          "Gender": "FEMALE",
          "FaceId": "59edc040d0a8f4952b183d1b5044913a0ccd8739500ee2705ffe4965a0406a51",
          "GenderConfidence": 1,
          "FaceAttributes": {
            "GlassesConfidence": 1,
            "Glasses": "NONE",
            "Mask": "NONE",
            "BeardConfidence": 1,
            "MaskConfidence": 1,
            "FaceBoundary": {
              "Top": 152,
              "Width": 139,
              "Height": 141,
              "Left": 267
            },
            "HeadPose": {
              "Pitch": 18.385589599609375,
              "Roll": 4.204030513763428,
              "Yaw": 2.4945924282073975
            },
            "Beard": "NONE"
          },
          "FaceQuality": 0.9321779608726501,
          "Emotion": "HAPPY",
          "Age": 29,
          "FaceConfidence": 0.9608758687973022,
          "EmotionConfidence": 0.7079545259475708,
          "Attractive": 0.96,
          "GroupId": "group-not-grouped",
          "EmotionDetails": {
            "HAPPY": 0.7079545259475708,
            "SURPRISED": 0.00006676767952740192,
            "CALM": 0.2918718755245209,
            "DISGUSTED": 0.000033771051676012576,
            "ANGRY": 0.00001282201901631197,
            "SAD": 0.00001527295717096422,
            "SCARED": 0.0000014976058082538657
          }
        }
      ],
      "ImageQualityStatus": "Success",
      "OCRFailReason": "Timeout",
      "AddressFailReason": "Timeout",
      "ImageQuality": {
        "OverallScore": 0.7759467363357544,
        "Color": 0.6101377010345459,
        "ColorScore": 0.6101377010345459,
        "ContrastScore": 0.6101377010345459,
        "Contrast": 0.6101377010345459,
        "ExposureScore": 0.6101377010345459,
        "ClarityScore": 0.6101377010345459,
        "Clarity": 0.6101377010345459,
        "Exposure": 0.6101377010345459,
        "CompositionScore": 0.6101377010345459
      },
      "CroppingSuggestionModifyTime": "2020-11-25T10:12:59.57Z",
      "ImageFormat": "jpg",
      "ImageWidth": 500,
      "RemarksArrayB": "[\"remarkb1\",\"remarkb2\"]",
      "CroppingSuggestion": [
        {
          "Score": 0.8979608535766602,
          "CroppingBoundary": {
            "Top": 77,
            "Width": 500,
            "Height": 499,
            "Left": 0
          },
          "AspectRatio": "1:1"
        }
      ],
      "Orientation": "{\"val\":\"Right-top\",\"type\":3}",
      "RemarksD": "remarkd",
      "TagsStatus": "Success",
      "CroppingSuggestionFailReason": "Timeout",
      "RemarksA": "remarka",
      "ImageUri": "oss://imm-test/testcases/face1.jpg",
      "TagsModifyTime": "2020-11-25T10:12:59.57Z",
      "OCRStatus": "NotProcessed",
      "AddressStatus": "Success",
      "Exif": "{\"FileSize\":{\"value\":\"29304\"},\"Format\":{\"value\":\"jpg\"},\"ImageHeight\":{\"value\":\"417\"},\"ImageWidth\":{\"value\":\"500\"},\"ResolutionUnit\":{\"value\":\"2\"},\"XResolution\":{\"value\":\"96/1\"},\"YResolution\":{\"value\":\"96/1\"}}",
      "Location": "30.134390,120.074997",
      "RemarksB": "remarkb"
    }
  ],
  "NextMarker": "CAESBgoEIgIIABgAIswBCskBA8QAAAAxUzMxMzczNDM2MzQzOTM1MzgzNTM3MzYzMDMyMzczNDM1M2E2OTZkNmQ2OTZkNjE2NzY1M2E3MzY1NzQzMDMwMzEzYTMxMzYzMzM1NjIzOTMzMzI2MTYyMzQzNzY2NjMzNjY2NjI2MTYxMzMzMjM1MzQzOTMzMzQzNzMwMzI2NTMxNjE2MjM3MzczMTY0NjM2NDM2MzgzNjM4NjQzMjM2MzEzNzM2MzYzNjM4NjUzNTYyMzc2NjM0MzU2MjYxNjE2NTMx",
  "SetId": "set001"
}

错误码

访问错误中心查看更多错误码。