FindImagesByTagNames 按标签搜索图片
描述
根据给定的标签列表,搜索媒体集 Set 内的图片。
搜索结果依赖索引的建立,返回结果与实际值可能有数秒的数据延迟。
请求参数
Parameter | Type | Required | Comment |
---|---|---|---|
Project | string | Y | Project 名称。 |
SetId | string | Y | 媒体集 Set 的唯一标识。 |
TagNames | []string | Y | 标签列表。给定多个时,为“与”的关系,即图片中同时具有输入的多个标签。 [“猫”] |
Marker | string | N | Marker 翻页标记 |
返回参数
Parameter | Type | Comment | |
---|---|---|---|
RequestId | string | 该次请求的唯一识别码。 | |
SetId | string | 媒体集 Set 的唯一标识。 | |
Images | []Image | 搜索到的图片详细信息数组。 | |
NextMarker | string | Marker 翻页标记 | |
Limit | int | N | 返回结果的最大数量,1~100,默认20 |
示例
请求示例
POST https://imm.cn-shanghai.aliyuncs.com
?Action=FindImagesByTagNames
&Project=test-project
&SetId=test-set
&TagNames=["猫"]
...
此处的示例,目的是展示关键参数,还需要其他的公共参数才能正常调用,推荐使用 SDK 来发送 API。
返回参数
Parameter | Type | Comment |
---|---|---|
RequestId | string | 该次请求的唯一识别码。 |
SetId | string | 媒体集 Set 的唯一标识。 |
Images | []Image | 搜索到的图片详细信息数组。 |
NextMarker | string | Marker 翻页标记 |
成功返回示例
{
"RequestId": "45E6DF1A-8BA9-4625-92E5-7CC3720AE6AA",
"Images": [
{
"FacesModifyTime": "2018-12-10T13:21:04Z",
"RemarksC": "",
"RemarksD": "",
"ExternalId": "",
"Faces": [],
"SourcePosition": "",
"Exif": "{\n \"FileSize\": {\"value\": \"63362\"},\n \"Format\": {\"value\": \"jpg\"},\n \"ImageHeight\": {\"value\": \"480\"},\n \"ImageWidth\": {\"value\": \"640\"},\n \"ResolutionUnit\": {\"value\": \"2\"},\n \"XResolution\": {\"value\": \"72/1\"},\n \"YResolution\": {\"value\": \"72/1\"}}",
"ImageUri": "oss://imm-test/testcases/test.jpg",
"ImageWidth": 640,
"ImageFormat": "jpg",
"SourceType": "image",
"ModifyTime": "2018-12-10T13:21:02Z",
"FileSize": 63362,
"Tags": [
{
"TagConfidence": 0.9903369545936584,
"TagLevel": 1,
"TagName": "动物"
},
{
"TagConfidence": 0.9903369545936584,
"TagLevel": 2,
"ParentTagName": "动物",
"TagName": "宠物"
},
{
"TagConfidence": 0.9903369545936584,
"TagLevel": 3,
"ParentTagName": "宠物",
"TagName": "猫"
},
{
"TagConfidence": 0.6040770411491394,
"TagLevel": 4,
"ParentTagName": "猫",
"TagName": "狸花猫"
}
],
"SourceUri": "oss://imm-test/testcases/test.jpg",
"CreateTime": "2018-12-10T13:21:02Z",
"RequestId": "072C5C98-1284-46C6-80FB-0DD5B4C5EA87",
"FacesStatus": "Success",
"TagsStatus": "Success",
"FacesFailReason": "",
"TagsFailReason": "",
"RemarksA": "",
"SetId": "test-set",
"ImageHeight": 480,
"RemarksB": ""
}
],
"SetId": "Set-b247df7d-1072-4c56-85eb-b9f4813a0e44",
"NextMarker": ""
}
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论