图像搜索 ImageSearch-华为云

图像搜索 ImageSearch-公共说明:公共配置

公共配置用户创建服务实例时，需要填写公共配置信息。公共配置主要包含如下内容：实例描述（desc）: 服务实例描述信息，用于对服务实例进行文字说明或备注。字符标签（custom_tags）: 自定义字符标签列表，用于添加数据时设置标签值，并在搜索时进行枚举过滤。数值标签（custom_num_tags）: 自定义数值标签列表，用于添加数据时设置标签值，并在搜索时进行范围过滤。 "desc": "通用商品搜索实例","custom_tags": ["spu_id", "brand", "style"],"custom_num_tags": ["price", "year", "status"]

图像搜索 ImageSearch

图像搜索 ImageSearch-什么是图像搜索:产品功能

产品功能通用搜索通用搜索（General Search）提供通用场景下的相同或相似图像搜索能力，针对入库的图像数据提供一站式的通用化搜索能力，目前包括图像检索图像、关键词检索图像、文本检索图像。商品搜索商品搜索（E-commerce Search）提供电商场景下的搜索能力，目前包括通用商品搜索和服装商品搜索。通用商品搜索，旨在针对入库的图像数据提供商品类目的目标搜索能力，目前支持12类的全品类商品搜索；服装商品搜索，旨在针对入库的图像数据提供服装垂域的目标搜索能力，目前支持上装/裤装/裙装/内衣的全品类服装商品搜索。

图像搜索 ImageSearch

图像搜索 ImageSearch-通用搜索

通用搜索功能介绍通用图像搜索，旨在针对入库的图像数据提供通用场景下的相同或相似图像搜索能力，目前包括图像检索图像、关键词检索、文本检索图像。用户在开启相应的检索子能力后，可以分别使用图像、关键词和文本对入库的图像进行搜索。应用场景相同或相似图像搜索：从海量图像库中快速搜索相同或相似的的图像，可以应用于图像推荐、审核等业务中。图文跨模态搜索根据文本描述从图像库中搜索与其语义一致的图像，可以应用于素材查找、图库管理等业务中。父主题：功能介绍

图像搜索 ImageSearch

图像搜索 ImageSearch-商品搜索

商品搜索功能介绍通用商品图像搜索针对入库的图像数据提供商品类目的目标搜索能力，目前支持12类的全品类商品搜索。服装商品图像搜索针对入库的图像数据提供服装垂域的目标搜索能力，目前支持上装/裤装/裙装/内衣的全品类服装商品搜索。应用场景商品图像搜索基于用户提供的图像在商品库中进行搜索，找到同款或相似的商品，可以应用于商品搜索、推荐等业务中。图1 商品图像搜索示例图服装版型搜索根据参考的服装图像搜索设计版型相似的服装，可以应用于服装设计、服装库管理等业务中。父主题：功能介绍

图像搜索 ImageSearch 功能介绍

图像搜索 ImageSearch-图像类说明:通用商品搜索

通用商品搜索搜索类型通用商品搜索目前仅支持CATEGORY一种搜索类型。 CATEGORY: 类目检索。高级配置通用商品搜索允许用户对服务实例进行高级配置，以满足业务应用的差异化需求。商品图像配置添加图像商品数量: 单张图像允许的最大添加商品数量，默认为1，取值范围为[1, 3]。该配置对有效并发影响较大，需要根据实际情况合理配置。搜索图像商品数量: 搜索图像返回的最大检测商品数量，默认为3，取值范围为[1, 5]。搜索时会直接使用最显著商品进行搜索，同时返回图像中所有商品用于后续精准搜索。请求高阶参数通用商品搜索允许用户在调用API接口时传递高阶参数，以满足业务应用的差异化需求。 CATEGORY 针对类目检索的搜索类型，服务实例具有如下高阶请求参数：添加数据API do_det: 是否进行目标检测，默认为true。 box: 目标矩形框左边，如给定则不进行目标检测，直接使用该box作为目标。 do_cls: 是否进行对象分类，默认为true。 category: 对象类目，如给定则不进行对象分类，直接使用该category作为类目。 { "do_det": true, "box": "50,100,200,300", "do_cls": true, "category": 1} 搜索API do_det: 是否进行目标检测，默认为true。 box: 目标矩形框左边，如给定则不进行目标检测，直接使用该box作为目标。 do_cls: 是否进行对象分类，默认为true。 category: 对象类目，如给定则不进行对象分类，直接使用该category作为类目。 collapse_key: 去重标签名，如给定则会基于其对搜索结果进行去重。 { "do_det": true, "box": "50,100,200,300", "do_cls": true, "category": 1, "collapse_key": "spu_id"} 响应高阶字段通用商品搜索的请求响应存在高阶字段，以满足业务应用的潜在感知需求。 CATEGORY 针对类目检索的搜索类型，服务实例具有如下高阶响应字段：添加数据API image_info: 添加图像数据的相关信息。 { "image_info": { "objects": [ { "box": "135,489,1117,1341", "category": 1, "category_name": "top" } ] }} 搜索API image_info: 搜索图像的相关信息。 { "image_info": { "box": "135,489,1117,1341", "category": 1, "category_name": "top", "objects": [ { "category_name": "top", "box": "135,489,1117,1341", "category": 1 }, { "category_name": "others", "box": "373,99,661,468", "category": 0 } ] }} 商品类目通用商品搜索支持的商品类目详见表1。表1 通用商品类目表类目ID 英文描述中文描述 0 others 其他商品 1 top 上装 2 bottom 裤子 3 skirt 裙装 4 underwear 内衣 5 jewelry 珠宝配饰 6 bags 箱包 7 shoes 鞋 8 toy 玩具 9 furniture 家具 10 health_beauty 美容与健康 11 electronics 数码电子产品

图像搜索 ImageSearch 服务类型说明

图像搜索 ImageSearch-图像类说明:通用图像搜索

通用图像搜索搜索类型通用图像搜索目前支持IMAGE/KEYWORD/TEXT三种搜索类型，用户可根据业务需要选择启用一种或多种搜索类型。 IMAGE: 图像检索。 KEYWORD: 关键词检索。 TEXT: 文本检索。高级配置通用图像搜索允许用户对服务实例进行高级配置，以满足业务应用的差异化需求。图像关键词配置语言类型: 自动生成的关键词语言，可选zh/en，默认zh。最大数量: 关键词返回数量，默认为50，取值范围为[1, 100]。置信度阈值: 关键词置信度阈值，默认为20，取值范围为[0, 100]。

图像搜索 ImageSearch 服务类型说明

图像搜索 ImageSearch-图像类说明:服装商品搜索

服装商品搜索搜索类型服装商品搜索目前仅支持CATEGORY一种搜索类型。 CATEGORY: 类目检索。高级配置服装商品搜索允许用户对服务实例进行高级配置，以满足业务应用的差异化需求。商品图像配置添加图像商品数量: 单张图像允许的最大添加商品数量，默认为1，取值范围为[1, 3]。该配置对有效并发影响较大，需要根据实际情况合理配置。搜索图像商品数量: 搜索图像返回的最大检测商品数量，默认为3，取值范围为[1, 5]。搜索时会直接使用最显著商品进行搜索，同时返回图像中所有商品用于后续精准搜索。请求高阶参数服装商品搜索允许用户在调用API接口时传递高阶参数，以满足业务应用的差异化需求。 CATEGORY 针对类目检索的搜索类型，服务实例具有如下高阶请求参数：添加数据API do_det: 是否进行目标检测，默认为true。 box: 目标矩形框左边，如给定则不进行目标检测，直接使用该box作为目标。 do_cls: 是否进行对象分类，默认为true。 category: 对象类目，如给定则不进行对象分类，直接使用该category作为类目。 { "do_det": true, "box": "50,100,200,300", "do_cls": true, "category": 1} 搜索API do_det: 是否进行目标检测，默认为true。 box: 目标矩形框左边，如给定则不进行目标检测，直接使用该box作为目标。 do_cls: 是否进行对象分类，默认为true。 category: 对象类目，如给定则不进行对象分类，直接使用该category作为类目。 collapse_key: 去重标签名，如给定则会基于其对搜索结果进行去重。 { "do_det": true, "box": "50,100,200,300", "do_cls": true, "category": 1, "collapse_key": "spu_id"} 响应高阶字段服装商品搜索的请求响应存在高阶字段，以满足业务应用的潜在感知需求。 CATEGORY 针对类目检索的搜索类型，服务实例具有如下高阶响应字段：添加数据API image_info: 添加图像数据的相关信息。 { "image_info": { "objects": [ { "box": "135,489,1117,1341", "category": 1, "category_name": "top" } ] }} 搜索API image_info: 搜索图像的相关信息。 { "image_info": { "box": "135,489,1117,1341", "category": 1, "category_name": "top", "objects": [ { "category_name": "top", "box": "135,489,1117,1341", "category": 1 }, { "category_name": "others", "box": "373,99,661,468", "category": 0 } ] }} 商品类目服装商品搜索支持的商品类目详见表2。表2 服装商品类目表类目ID 英文描述中文描述 0 others 其他商品 1 top 上装 2 bottom 裤子 3 skirt 裙装 4 underwear 内衣

图像搜索 ImageSearch 服务类型说明

图像搜索 ImageSearch-计费说明:到期与欠费

到期与欠费包年包月资源包到期后，自动转为按需计费。按需计费是按照每小时扣费，当账户的余额不足时，无法对上一个小时的费用进行扣费，就会导致欠费。如果账号欠费，会根据“客户等级”来定义保留期时长，保留期内资源处理和费用详见宽限期与保留期。您续费后可继续正常使用。保留期满仍未续订或充值，数据将被删除且无法恢复。在保留期进行的续费，是以原到期时间作为生效时间，您应当支付从进入保留期开始到续费时的服务费用。您账号欠费后，会导致部分操作受限，建议您尽快续费。具体受限操作如下：开通服务购买套餐包按需计费模式的API无法调用

图像搜索 ImageSearch

图像搜索 ImageSearch-计费说明:计费项

计费项图像搜索服务的计费项包含索引存储数量和搜索查询次数。表1 计费项说明计费项计费项说明索引存储V2 通过添加数据V2、删除数据V2接口对实例中的索引存储数量进行管理。搜索查询V2 搜索查询API的调用次数。由于存在资源占用，单个服务实例的存储数量存在计费下限，不同存储规格的服务实例存储数量下限分别为各自存储规格的10%，且最低存储数量下限为10万，实际存储数量小于数量下限时按照数量下限计费，大于数量下限时按实际数量计费。实例支持多个搜索类型时，索引存储数量超过存储下限时，按索引存储数量 * 搜索类型数计费。例如：当选择3种搜索类型"IMAGE"、"KEYWORD"、"TEXT"时，存储计费为1种搜索类型的索引存储数量费用*3。搜索查询V2，添加数据V2默认QPS为5。只有调用成功才会计算搜索次数，其中返回的2xx状态码表示调用成功，调用失败不计费。如您后续不再使用图像搜索服务，需要将索引存储实例库删除，避免产生额外的存储费用，可登陆控制台在实例管理中删除。

图像搜索 ImageSearch

图像搜索 ImageSearch-使用限制:系统级约束

系统级约束服务区域仅支持“华为-北京四”。请求body使用标准json格式，且大小不超过12M。默认不保存用户的图像或视频等数据。实例数量：每个用户默认可创建5个服务实例。如需创建更多服务实例，请联系华为云客服。接口并发：每个用户的默认搜索接口并发为5QPS。有更高的接口并发需求请联系华为云客服，接口并发调整需要额外收费。存储规格：创建服务实例的存储规格为当前实例可容纳索引个数上限，最大可创建5000万存储规格实例，有其他的的存储规格需求请联系华为云客服。默认不支持调整已创建服务实例的存储规格，有特殊需求需要调整，请联系华为云客服。

图像搜索 ImageSearch

图像搜索 ImageSearch-添加数据 V2:响应参数

响应参数状态码： 200 表4 响应Body参数参数参数类型描述 result String 添加数据完成返回success。 data AddDataRestInfo object 添加数据的相关信息。表5 AddDataRestInfo 参数参数类型描述 image_info image_info object 添加图像数据的相关信息，不同服务类型返回信息不同，具体可参见服务类型说明。表6 image_info 参数参数类型描述 objects Array of objects objects 添加的主体列表。表7 objects 参数参数类型描述 box String 主体目标框。 category Integer 主体类目序号。 category_name String 主体类目名称。状态码： 400 表8 响应Body参数参数参数类型描述 error_code String 调用失败时的错误码，具体请参见错误码。调用成功时无此字段。 error_msg String 调用失败时的错误信息。调用成功时无此字段。

图像搜索 ImageSearch

图像搜索 ImageSearch-添加数据 V2:响应示例

响应示例状态码： 200 响应成功示例 { "result" : "success", "data" : { "image_info" : { "objects" : [ { "box" : "26,223,771,704", "category" : 11, "category_name" : "electronics" } ] } }} 状态码： 400 响应失败示例 { "error_code" : "MMS.0003", "error_msg" : "Invalid parameter: item_id"}

图像搜索 ImageSearch

图像搜索 ImageSearch-添加数据 V2:请求示例

请求示例添加商品图像数据，使用图像BASE64编码 POST https://{endpoint}/v2/{project_id}/mms/{service_name}/data/add{ "item_id" : "electronics_01", "image_base64" : "/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAA...", "desc" : "天地纵横自然", "custom_tags" : { "brand" : "HUAWEI" }, "custom_num_tags" : { "year" : 2022 }}

图像搜索 ImageSearch

图像搜索 ImageSearch-更新数据 V2:请求示例

请求示例更新数据 POST https://{endpoint}/v2/{project_id}/mms/{service_name}/data/update{ "item_id" : "electronics_01", "desc" : "摄与山海之间，水天相接", "custom_tags" : { "brand" : "HUABAN" }, "custom_num_tags" : { "year" : 2023 }}

图像搜索 ImageSearch

图像搜索 ImageSearch-状态码

状态码 HTTP 状态码为三位数，分成五个类别：1xx：相关信息；2xx：操作成功；3xx：重定向；4xx：客户端错误；5xx：服务器错误。具体的状态码参见表1所示。表1 状态码状态码编码错误码说明 100 Continue 继续请求。这个临时响应用来通知客户端，它的部分请求已经被服务器接收，且仍未被拒绝。 101 Switching Protocols 切换协议。只能切换到更高级的协议。例如，切换到HTTPS的新版本协议。 201 Created 创建类的请求完全成功。 202 Accepted 已经接受请求，但未处理完成。 203 Non-Authoritative Information 非授权信息，请求成功。 204 NoContent 请求完全成功，同时HTTP响应不包含响应体。在响应OPTIONS方法的HTTP请求时返回此状态码。 205 Reset Content 重置内容，服务器处理成功。 206 Partial Content 服务器成功处理了部分GET请求。 300 Multiple Choices 多种选择。请求的资源可包括多个位置，相应可返回一个资源特征与地址的列表用于用户终端（例如：浏览器）选择。 301 Moved Permanently 永久移动，请求的资源已被永久的移动到新的URI，返回信息会包括新的URI。 302 Found 资源被临时移动。 303 See Other 查看其它地址。使用GET和POST请求查看。 304 Not Modified 所请求的资源未修改，服务器返回此状态码时，不会返回任何资源。 305 Use Proxy 所请求的资源必须通过代理访问。 306 Unused 已经被废弃的HTTP状态码。 400 BadRequest 非法请求。建议直接修改该请求，不要重试该请求。 401 Unauthorized 在客户端提供认证信息后，返回该状态码，表明服务端指出客户端所提供的认证信息不正确或非法。 402 Payment Required 保留请求。 403 Forbidden 请求被拒绝访问。返回该状态码，表明请求能够到达服务端，且服务端能够理解用户请求，但是拒绝做更多的事情，因为该请求被设置为拒绝访问，建议直接修改该请求，不要重试该请求。 404 NotFound 所请求的资源不存在。建议直接修改该请求，不要重试该请求。 405 MethodNotAllowed 请求中带有该资源不支持的方法。建议直接修改该请求，不要重试该请求。 406 Not Acceptable 服务器无法根据客户端请求的内容特性完成请求。 407 Proxy Authentication Required 请求要求代理的身份认证，与401类似，但请求者应当使用代理进行授权。 408 Request Time-out 服务器等候请求时发生超时。客户端可以随时再次提交该请求而无需进行任何更改。 409 Conflict 服务器在完成请求时发生冲突。返回该状态码，表明客户端尝试创建的资源已经存在，或者由于冲突请求的更新操作不能被完成。 410 Gone 客户端请求的资源已经不存在。返回该状态码，表明请求的资源已被永久删除。 411 Length Required 服务器无法处理客户端发送的不带Content-Length的请求信息。 412 Precondition Failed 未满足前提条件，服务器未满足请求者在请求中设置的其中一个前提条件。 413 Request Entity Too Large 由于请求的实体过大，服务器无法处理，因此拒绝请求。为防止客户端的连续请求，服务器可能会关闭连接。如果只是服务器暂时无法处理，则会包含一个Retry-After的响应信息。 414 Request-URI Too Large 请求的URI过长（URI通常为网址），服务器无法处理。 415 Unsupported Media Type 服务器无法处理请求附带的媒体格式。 416 Requested range not satisfiable 客户端请求的范围无效。 417 Expectation Failed 服务器无法满足Expect的请求头信息。 422 UnprocessableEntity 请求格式正确，但是由于含有语义错误，无法响应。 429 TooManyRequests 表明请求超出了客户端访问频率的限制或者服务端接收到多于它能处理的请求。建议客户端读取相应的Retry-After首部，然后等待该首部指出的时间后再重试。 500 InternalServerError 表明服务端能被请求访问到，但是不能理解用户的请求。 501 Not Implemented 服务器不支持请求的功能，无法完成请求。 502 Bad Gateway 充当网关或代理的服务器，从远端服务器接收到了一个无效的请求。 503 ServiceUnavailable 被请求的服务无效。建议直接修改该请求，不要重试该请求。 504 ServerTimeout 请求在给定的时间内无法完成。客户端仅在为请求指定超时（Timeout）参数时会得到该响应。 505 HTTP Version not supported 服务器不支持请求的HTTP协议的版本，无法完成处理。父主题：附录

图像搜索 ImageSearch

云服务器内容精选

图像搜索 ImageSearch

7*24

备案

专业服务

退订

建议反馈

售前咨询热线