跳到主要内容

图像搜索

接口路径

POST /api/search/image

请求方法

POST

频率限制

详见套餐说明

请求体

请求体为json对象

参数名参数类型备注
imageBase64String与imageUrl二选一,dataURI格式的图片base64编码,例如:data:image/jpeg;base64,xxxx
imageUrlString与imageBase64二选一,图片url
regionString用户选择的当前切图返回的坐标,不能超过图片边界

请求体示例

{
"imageBase64": "data:image/jpeg;base64,xxxx",
"imageUrl": "https://www.test.com/test.png",
"region": "421,1678,538,2243"
}

响应体

字段名字段类型备注
codeInteger状态码,200 表示成功
msgString返回消息,成功时为 null
dataArray联想词列表,包含联想词和出现次数
data.multiRegionArray图片识别出的多个区域坐标,格式为 x1,x2,y1,y2 字符串
data.currentRegionString当前结构区域坐标,格式为 x1,x2,y1,y2 字符串
data.productsArray商品数组
data.products[].brandstring商品品牌
data.products[].productIdstring商品聚合 ID
data.products[].productNamestring商品名称
data.products[].mainImagestring商品白底图
data.products[].imageUrlsarray商品图片 URL 列表
data.products[].descriptionstring商品描述
data.products[].genderstring商品适用性别
data.products[].seriesstring商品系列
data.products[].categorystring商品分类
data.products[].stylestring商品款式
data.products[].colorstring商品颜色
data.products[].sizestring商品尺寸
data.products[].materialstring商品材质
data.products[].designstring商品设计
data.products[].pricenumber商品价格
data.products[].discountPricenumber商品折扣价
data.products[].statusinteger商品状态
data.products[].isNewstring是否为新商品
data.products[].releaseDatestring商品发布日期
data.products[].attr1string自定义冗余字段
data.products[].attr2string自定义冗余字段
data.products[].attr3string自定义冗余字段
data.products[].attr4string自定义冗余字段
data.products[].attr5string自定义冗余字段
data.products[].attr6string自定义冗余字段
data.products[].attr7string自定义冗余字段
data.products[].attr8string自定义冗余字段
data.products[].attr9string自定义冗余字段
data.products[].attr10string自定义冗余字段
data.products[].colorsArray颜色数组对象
data.products[].colors[].colorIdString颜色级别的商品id,如果没有可以不填
data.products[].colors[].colorString颜色,可用于颜色筛选
data.products[].colors[].rbgaString颜色RGBA
data.products[].colors[].mainImageString商品白底图
data.products[].colors[].imagesArray商品图片 URL 列表
data.products[].colors[].priceBigDecimal颜色级别的商品价格
data.products[].colors[].attr1String自定义冗余字段,会在搜索结果中返回,可用于颜色筛选
data.products[].colors[].attr2String自定义冗余字段,会在搜索结果中返回,可用于颜色筛选
data.products[].colors[].attr3String自定义冗余字段,会在搜索结果中返回,可用于颜色筛选
data.products[].colors[].sizesArray尺码数组对象
data.products[].colors[].sizes[].sizeIdString尺码级别的商品id,如果没有可以不填
data.products[].colors[].sizes[].sizeString尺码
data.products[].colors[].sizes[].priceBigDecimal颜色级别的商品价格
data.products[].colors[].sizes[].attr1