全部产品
云市场

FindImagesByTagNames 按标签搜索图片

更新时间:2019-03-11 16:58:00

描述

根据给定的标签列表,搜索媒体集 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

示例

请求示例

  1. POST https://imm.cn-shanghai.aliyuncs.com
  2. ?Action=FindImagesByTagNames
  3. &Project=test-project
  4. &SetId=test-set
  5. &TagNames=["猫"]
  6. ...

此处的示例,目的是展示关键参数,还需要其他的公共参数才能正常调用,推荐使用 SDK 来发送 API

返回参数

Parameter Type Comment
RequestId string 该次请求的唯一识别码。
SetId string 媒体集 Set 的唯一标识。
Images []Image 搜索到的图片详细信息数组。
NextMarker string Marker 翻页标记

成功返回示例

  1. {
  2. "RequestId": "45E6DF1A-8BA9-4625-92E5-7CC3720AE6AA",
  3. "Images": [
  4. {
  5. "FacesModifyTime": "2018-12-10T13:21:04Z",
  6. "RemarksC": "",
  7. "RemarksD": "",
  8. "ExternalId": "",
  9. "Faces": [],
  10. "SourcePosition": "",
  11. "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\"}}",
  12. "ImageUri": "oss://imm-test/testcases/test.jpg",
  13. "ImageWidth": 640,
  14. "ImageFormat": "jpg",
  15. "SourceType": "image",
  16. "ModifyTime": "2018-12-10T13:21:02Z",
  17. "FileSize": 63362,
  18. "Tags": [
  19. {
  20. "TagConfidence": 0.9903369545936584,
  21. "TagLevel": 1,
  22. "TagName": "动物"
  23. },
  24. {
  25. "TagConfidence": 0.9903369545936584,
  26. "TagLevel": 2,
  27. "ParentTagName": "动物",
  28. "TagName": "宠物"
  29. },
  30. {
  31. "TagConfidence": 0.9903369545936584,
  32. "TagLevel": 3,
  33. "ParentTagName": "宠物",
  34. "TagName": "猫"
  35. },
  36. {
  37. "TagConfidence": 0.6040770411491394,
  38. "TagLevel": 4,
  39. "ParentTagName": "猫",
  40. "TagName": "狸花猫"
  41. }
  42. ],
  43. "SourceUri": "oss://imm-test/testcases/test.jpg",
  44. "CreateTime": "2018-12-10T13:21:02Z",
  45. "RequestId": "072C5C98-1284-46C6-80FB-0DD5B4C5EA87",
  46. "FacesStatus": "Success",
  47. "TagsStatus": "Success",
  48. "FacesFailReason": "",
  49. "TagsFailReason": "",
  50. "RemarksA": "",
  51. "SetId": "test-set",
  52. "ImageHeight": 480,
  53. "RemarksB": ""
  54. }
  55. ],
  56. "SetId": "Set-b247df7d-1072-4c56-85eb-b9f4813a0e44",
  57. "NextMarker": ""
  58. }

若在使用中有疑问,请参考 FAQ,或者进入 钉钉用户群 实时交流。