检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
响应示例如下，例如图像搜索服务部署的区域为"cn-north-4"，响应消息体中查找“name”为"cn-north-4"，其中projects下的“id”即为项目ID。
使用准备 服务开通 使用前，请登录图像搜索服务控制台开通服务。服务开通后，可以根据使用需求购买折扣套餐包。 创建服务实例 开通服务后，用户可以根据自身的业务需求和规模，在图像搜索服务“控制台->实例管理->实例创建“界面创建自定义配置的服务实例。
获取账号名和账号ID 在调用接口的时候，部分请求中需要填入账号名（domain name）和账号ID（domain_id）。获取步骤如下： 注册并登录管理控制台。 鼠标移动至用户名，在下拉列表中单击“我的凭证”。 在“API凭证”页面的查看“账号名”和“账号ID”。 图1 查看账号
服务类型 服务类型，指用户搜索数据的的具体业务应用，即用户需要将搜索服务具体应用于什么业务中。 例如：IMAGE->商品搜索->通用商品搜索，表示用户需要在全品类商品搜索的业务应用中进行图像数据的搜索。
当调用出错时，返回的消息体中是具体的错误代码及错误信息。在调用方找不到错误原因时，可以联系华为云客服，并提供错误码，以便我们尽快帮您解决问题。 错误响应说明 当接口调用出错时，会返回错误码及错误信息说明，错误响应的Body体格式如下所示。
图1 获取用户Token响应消息头 响应消息体 响应消息体通常以结构化格式返回，与响应消息头中Content-type对应，传递除响应消息头之外的内容。 对于获取用户Token接口，返回如下消息体。为篇幅起见，这里只展示部分内容。
调用服务时错误码显示“ModelArts.4204”怎么处理？ 调用接口出错后，返回的消息体中具体的错误代码及错误信息为： { "error_code":"ModelArts.4204", "error_msg":"Request api error!
获取Token，请参考《统一身份认证服务API参考》的“获取用户Token”章节。请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。
共有三种方式可以基于已构建好的请求消息发起请求。 cURL cURL是一个命令行工具，用来执行各种URL操作和信息传输。cURL充当的是HTTP客户端，可以发送HTTP请求给服务端，并接收响应消息。cURL适用于接口调试。
API概览 图像搜索服务所提供的API为自研API。通过使用服务的自研API，您可以完整的使用如下所有功能。 API说明章节中请求示例均采用Token方式请求消息头，在实际使用过程中可根据情况选择认证方式。 请求样例中的Token值以实际申请服务时所获取的Token值为准。
Endpoint 指定承载REST服务端点的服务器域名或IP，不同服务不同区域的Endpoint不同，您可以从终端节点中获取。 例如IAM服务在“华北-北京一”区域的Endpoint为“iam.cn-north-1.myhuaweicloud.com”。
建议：不要使用跨区域的OBS路径，如果OBS与调用服务部署区域不属于同一个区域，建议本地下载图片后使用image_base64的调用方式。 父主题： 错误码问题
service_name 是 String 服务实例的名称，用户创建服务实例时指定。 请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 item_id 否 String 数据的服务实例级唯一标识，字符长度范围为[1, 256]。
key: 必须为服务实例custom_num_tags中已存在的key，可在创建服务实例时进行配置，或在更新服务实例时进行新增。针对没有设置该数值标签的数据，会直接过滤。 value: 标签值的取值范围，标签值在给定的取值范围内即视为符合条件。
key: 必须为服务实例custom_num_tags中已存在的key，可在创建服务实例时进行配置，或在更新服务实例时进行新增。 value: 类型为数值，格式为double。
CATEGORY 针对类目检索的搜索类型，服务实例具有如下高阶响应字段： 添加数据API image_info: 添加图像数据的相关信息。
key: 必须为服务实例custom_tags中已存在的key，可在创建服务实例时进行配置，或在更新服务实例时进行新增。 value: 类型为字符串，字符长度范围为[1, 64]。
service_name 是 String 服务实例的名称，用户创建服务实例时指定。
更新数据示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用初始化UpdateParam中的custom_num_tags、custom_tags、desc、item_id配置服务输入参数，配置完成后运行即可。
更新数据示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用初始化UpdateParam中的custom_num_tags、custom_tags、desc、item_id配置服务输入参数，配置完成后运行即可。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
