添加数据-凯发k8国际娱乐官网入口
功能介绍
添加数据到用户指定的服务实例中。
服务实例需要用户在图像搜索服务管理控制台上创建。
调试
您可以在中调试该接口,支持自动认证鉴权。api explorer可以自动生成sdk代码示例,并提供sdk代码示例调试功能。
uri
post /v2/{project_id}/mms/{service_name}/data/add
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
string |
用户的项目id。获取方法请参见。 |
service_name |
是 |
string |
服务实例的名称,用户创建服务实例时设置的实例名称。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
force |
否 |
boolean |
是否强制添加数据,默认为false。
|
item_id |
是 |
string |
数据的服务实例级唯一标识,字符长度范围为[1, 256]。 |
desc |
否 |
string |
数据的描述信息,字符长度范围为[1, 2048]。 |
custom_tags |
否 |
map |
数据的自定义字符标签,用于进行条件过滤。格式为键值对{key:value}。
|
custom_num_tags |
否 |
map |
数据的自定义数值标签,用于进行条件过滤。格式为键值对{key:value}。
|
image_base64 |
否 |
string |
图像文件的base64字符串,图像入库时,与image_url二选一。要求如下:
|
image_url |
否 |
string |
图片的url路径,目前支持公网http:/https url,图像入库时,与image_base64二选一。
说明:
接口响应时间依赖于图片的下载时间,如果图片下载时间过长,会返回接口调用失败。 |
keywords |
否 |
array of strings |
关键词列表,关键词数量范围为[1, 100],关键词字符长度范围为[1, 64]。
说明:
支持关键词搜索的服务实例添加数据时,如给定此参数,则直接使用给定的keywords作为关键词,否则会自动生成对应的keywords。 |
optional_params |
否 |
adddataoptionalparam object |
添加数据的可选参数,具体可参见表3。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
do_det |
否 |
boolean |
是否进行目标检测,默认为true。 |
box |
否 |
string |
目标矩形框坐标。如给定则不进行目标检测,直接使用该box作为目标。格式为“x1,y1,x2,y2”(无空格),x1/y1为目标左上角坐标,x2/y2为目标右下角坐标,具体要求如下:
|
do_cls |
否 |
boolean |
是否进行对象分类,默认为true。 |
category |
否 |
integer |
对象类目,如给定则不进行对象分类,直接使用该category作为类目。具体类目信息可参见对应的服务类型说明。 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
result |
string |
添加数据完成返回success。 |
data |
adddatarestinfo object |
添加数据的相关信息。 |
参数 |
参数类型 |
描述 |
---|---|---|
image_info |
image_info object |
添加图像数据的相关信息,不同服务类型返回信息不同,具体可参见服务类型说明。 |
参数 |
参数类型 |
描述 |
---|---|---|
objects |
array of objects objects |
添加的主体列表。 |
参数 |
参数类型 |
描述 |
---|---|---|
box |
string |
主体目标框。 |
category |
integer |
主体类目序号。 |
category_name |
string |
主体类目名称。 |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
string |
调用失败时的错误码,具体请参见。 调用成功时无此字段。 |
error_msg |
string |
调用失败时的错误信息。 调用成功时无此字段。 |
请求示例
添加商品图像数据,使用图像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 } }
响应示例
状态码: 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" }
状态码
状态码 |
描述 |
---|---|
200 |
成功响应示例。 |
400 |
失败响应示例。 |
错误码
请参见。
意见反馈
文档内容是否对您有帮助?
如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨