› 推特 ›阿里云技术文档›正文

FindImagesByTagNames 按标签搜索图片_SetTags 媒体集标签处理_图片管理类操作_API手册_智能媒体管理

admin 阿里云技术文档 2020-02-11 211 0
阿里云服务器优惠

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

示例

请求示例

  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，或者进入 钉钉用户群 实时交流。

版权声明

本文仅代表作者观点，不代表本站立场。
本文系作者授权发表，未经许可，不得转载。

评论

-----