检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
HTTP方法 方法 说明 GET 请求服务器返回指定资源。 PUT 请求服务器更新指定资源。 POST 请求服务器新增资源或执行特殊操作。 DELETE 请求服务器删除指定资源，如删除对象等。 HEAD 请求服务器资源头部。 PATCH 请求服务器更新资源的部分内容。当资源不存在
服务类型说明 公共说明 图像类说明
图像类说明 图像类服务类型目前包含通用图像搜索、通用商品搜索、服装商品搜索等。 通用图像搜索 搜索类型 通用图像搜索目前支持IMAGE/KEYWORD/TEXT三种搜索类型，用户可根据业务需要选择启用一种或多种搜索类型。 IMAGE: 图像检索。 KEYWORD: 关键词检索。 TEXT:
公共说明 名词解释 数据类型 数据类型，指用户需要搜索的主要数据类型，即用户创建服务实例用于搜索什么类型的数据。 例如：IMAGE，表示用户需要搜索的为图像数据。 服务模板 服务模板，指用户搜索数据的基础业务流程，即用户需要在业务中按照什么流程进行数据搜索。 例如：IMAGE->
service type. 服务类型不存在 请检查服务类型是否正确。 MMS.1006 User info not found. 用户不存在 请检查用户名是否正确。 MMS.1007 There is no service type yet. 服务类型不存在 请检查服务类型是否支持。 MMS
表示从OBS获取图片数据失败，请确保存储图片的OBS路径存在且可访问，如果路径存在，请确保设置OBS桶策略为公共桶。建议：不要使用跨区域的OBS路径，如果OBS与调用服务部署区域不属于同一个区域，建议本地下载图片后使用image_base64的调用方式。 父主题： 错误码问题
与其他云服务的关系 统一身份认证服务 统一身份认证（Identity and Access Management，简称IAM）服务，IAM为图像搜索提供了用户认证和鉴权功能。 对象存储服务 对象存储服务（Object Storage Service，简称OBS）是稳定、安全、高效
API概览 图像搜索服务所提供的API为自研API。通过使用服务的自研API，您可以完整的使用如下所有功能。 API说明章节中请求示例均采用Token方式请求消息头，在实际使用过程中可根据情况选择认证方式。 请求样例中的Token值以实际申请服务时所获取的Token值为准。 en
状态码 请求发送以后，您会收到响应，包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。 对于获取用户Token接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对应请求消息头，响
有哪些途径可以使用图像搜索的API？ 共有三种方式可以基于已构建好的请求消息发起请求。 cURL cURL是一个命令行工具，用来执行各种URL操作和信息传输。cURL充当的是HTTP客户端，可以发送HTTP请求给服务端，并接收响应消息。cURL适用于接口调试。关于cURL详细信息请参见https://curl
调用图像搜索的API失败时怎么处理？ 检查原因 请确认当前账号是否欠费。如果欠费，请给账号充值。操作指导请参见华为云账户充值。 您在创建和调用OBS桶时，需保证您的OBS桶与图像搜索在同一个区域，不支持跨区域使用。例如同为“华北-北京一”区域，具体请参见图像搜索地区和终端节点。 根据API调用返
效率。 使用准备 服务开通 使用前，请登录图像搜索服务控制台开通服务。服务开通后，可以根据使用需求购买折扣套餐包。 创建服务实例 开通服务后，用户可以根据自身的业务需求和规模，在图像搜索服务“控制台->实例管理->实例创建“界面创建自定义配置的服务实例。 服务实例创建后，可以在“
商品图片不创建图库，直接用网络图库搜索图片可以吗？ 不可以，您需要自行提供用来搜索的图片库，利用图像搜索服务来创建实例将已有的图片库进行离线数据导入到OBS桶中，然后再进行搜索。 通过使用图像搜索服务的自研API，您可以完整的使用本服务的的所有功能，具体使用方法请参考：图像搜索API。 父主题： API使用类
终端节点 终端节点即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询所有服务的终端节点。 图像搜索的终端节点如表1所示，请您根据业务需要选择对应区域的终端节点。 表1 图像搜索的终端节点 区域名称 区域 终端节点（Endpoint） 华北-北京四
调用说明 图像搜索提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用。 同时图像搜索还提供多种编程语言的SDK供您使用，SDK的使用方法请参见：图像搜索SDK。 父主题： 使用前必读
使用限制 受技术、成本与交互多种因素制约，图像搜索服务存在一些使用限制。其中系统级限制，是针对服务整体的约束。除系统级限制外，各种服务子项还有独立的使用限制条件。 系统级约束 服务区域仅支持“华为-北京四”。 请求body使用标准json格式，且大小不超过12M。 默认不保存用户的图像或视频等数据。
AK/SK签名认证方式仅支持消息体大小12M以内，12M以上的请求请使用Token认证。 AK/SK签名认证通过API网关向下层服务发送请求时，必须使用AK、SK对请求进行签名，参见API签名指南。 AK/SK认证就是使用AK/SK对请求进行签名，在请求时将签名信息添加到消息头，从而通过身份认证。
Required 保留请求。 403 Forbidden 请求被拒绝访问。 返回该状态码，表明请求能够到达服务端，且服务端能够理解用户请求，但是拒绝做更多的事情，因为该请求被设置为拒绝访问，建议直接修改该请求，不要重试该请求。 404 NotFound 所请求的资源不存在。 建议直接修改该请求，不要重试该请求。
获取账号名和账号ID 在调用接口的时候，部分请求中需要填入账号名（domain name）和账号ID（domain_id）。获取步骤如下： 注册并登录管理控制台。 鼠标移动至用户名，在下拉列表中单击“我的凭证”。 在“API凭证”页面的查看“账号名”和“账号ID”。 图1 查看账号ID
参数 是否必选 参数类型 描述 project_id 是 String 用户的项目ID。获取方法请参见获取项目ID和名称。 service_name 是 String 服务实例的名称，用户创建服务实例时指定。 请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 force
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
