服务简介 :
本服务提供基于图像内容的相似图像搜索. 即用输入图片本身的颜色分布, 几何形状,
纹理来搜索相似图片, 并将结果按与输入图片的相似度打分排序.
海量图像 | 可轻松处理百万到千万量级图片 |
搜索速度快 | 50毫秒 – 500毫秒搜索响应速度 |
动态添加,修改,删除图片 | 可通过调用API动态添加, 修改,删除图片. 图片添加成功后可立即搜索. |
图片+关键词混合搜索 | 用图片内容本身, 加上关键词混合搜索给出更好搜索结果. |
图片类别筛选 | 搜索时可根据图片类别筛选结果 |
图片标签筛选 | 搜索时可根据图片标签筛选结果 |
应用场景 :
图像库交易平台, 电子商务网站或平台, 电子商务手机APP, 图片交易平台,
图片素材网站
接口地址 :http://apisim20.wozhitu.com:8084/vsearchtech/api/v1.0/apisim_search
图片格式要求: JPG格式,图像长及宽约300 – 800 像素图片
请求方法 : POST
请求参数(body) :
参数名 | 类型 | 必填 | 参数位置 | 描述 | 默认值 |
---|---|---|---|---|---|
apikey | string | 是 | body | API密钥 | 无 |
catid | int | 否 | body | 类别ID (0 – 30000 整数) | 0 (即搜索所有类别) |
lang | string | 否 | body | 返回语言: zh 中文; en 英文 | zh 中文 |
fmt | string | 否 | body | 返回结果格式: json或xml | json |
subject | string | 否 | body | 输入关键词, 用来进行图片+关键词混合搜索 | 无 |
labeland | string | 否 | body | 输入图片标签,正整数, 用AND逻辑标签筛选. 例子: 65,58,408 | 无 |
labelor | string | 否 | body | 输入图片标签,正整数, 用OR逻辑标签筛选. 例子: 305,38,5 | 无 |
labelnot | string | 否 | body | 输入图片标签,正整数,用NOT逻辑标签筛选. 例子: 345,368,45 | 无 |
p | string | 否 | body | 流览显示第p页面, p 为大于或等于1正整数 | 1 |
numperpage | string | 否 | body | 每页流览显示多少个, 应为正整数 | 16 |
maxitems | string | 否 | body | 最多一共流览显示多少个, 应为正整数 | 200 |
请求参数(body) :
参数名 | 类型 | 必填 | 参数位置 | 描述 | 默认值 |
---|---|---|---|---|---|
photo | file | 是 | body | 图片文件 | 无 |
{ resultList":[{"class":"vs.vscommon.ImageSearchResultEntry", "imgName":"1392125321.jpg","imgRelativePath": "0_All/41_xyz/0_All_Categories/227_e2/1392125321.jpg", "imgUrl":"http://www.xyz.cn/images/front/v/pic2/e2/04/1392125321.jpg","info":null,"keyword": "Study,Signature,5美分硬币,办公室,笔记本","productPageUrl": "http://www.xyz.cn/r/photo/view/id/1392125321/","score":0.9785203,"tagsList": null,"title":"Gold pen signing contract"},{"class":"vs.vscommon.ImageSearchResultEntry", "imgName":"1204325791.jpg","imgRelativePath":"0_All/41_xyz/0_All_Categories/53_34/1204325791.jpg", "imgUrl":"http://www.xyz.cn/images/front/v/pic2/34/ce/1204325791.jpg","info":null,"keyword": "白色,比例,局部,动物","productPageUrl":"http://www.xyz.cn/r/photo/view/id/1204325791/","score": 0.978022,"tagsList":null,"title":"Small fish in glass of water isolated"} ]}
接口地址 :http://apisim20.wozhitu.com:8084/vsearchtech/api/v1.0/apisim_search
图片格式要求: JPG格式300 – 800像素图片
请求方法 : POST
请求参数(body) :
参数名 | 类型 | 必填 | 参数位置 | 描述 | 默认值 |
---|---|---|---|---|---|
apikey | string | 是 | body | API密钥 | 无 |
imgurl | string | 是 | body | 图片地址URL | 无 |
catid | int | 否 | body | 类别ID (0 – 30000 整数) | 0 (即搜索所有类别) |
lang | string | 否 | body | 返回语言: zh 中文; en 英文 | zh 中文 |
fmt | string | 否 | body | 返回结果格式: json或xml | json |
subject | string | 否 | body | 输入关键词, 用来进行图片+关键词混合搜索 | 无 |
labeland | string | 否 | body | 输入图片标签,正整数, 用AND逻辑标签筛选. 例子: 65,58,408 | 无 |
labelor | string | 否 | body | 输入图片标签,正整数, 用OR逻辑标签筛选. 例子: 305,38,5 | 无 |
labelnot | string | 否 | body | 输入图片标签,正整数,用NOT逻辑标签筛选. 例子: 345,368,45 | 无 |
p | string | 否 | body | 流览显示第p页面, p 为大于或等于1正整数 | 1 |
numperpage | string | 否 | body | 每页流览显示多少个, 应为正整数 | 16 |
maxitems | string | 否 | body | 最多一共流览显示多少个, 应为正整数 | 200 |
{ resultList":[{"class":"vs.vscommon.ImageSearchResultEntry","imgName": "1392125321.jpg","imgRelativePath":"0_All/41_xyz/0_All_Categories/227_e 2/1392125321.jpg","imgUrl":"http://www.xyz.cn/images/front/v/pic2/e2 /04/1392125321.jpg","info":null,"keyword":"Study,Signature,5美分硬币, 办公室,笔记本","productPageUrl":"http://www.xyz.cn/r/photo/view/id/139 2125321/","score":0.9785203,"tagsList":null,"title":"Gold pen signi ng contract"},{"class":"vs.vscommon.ImageSearchResultEntry","imgName":" 1204325791.jpg","imgRelativePath":"0_All/41_xyz/0_All_Categories/53_34 /1204325791.jpg","imgUrl":"http://www.xyz.cn/images/front/v/pic2/34/ce /1204325791.jpg","info":null,"keyword":"白色,比例,局部,动物","productPageU rl":"http://www.xyz.cn/r/photo/view/id/1204325791/","score":0.978022, "tagsList":null,"title":"Small fish in glass of water isolated"}
接口地址 :http://apisim20.wozhitu.com:8084/vsearchtech/api/v1.0/apisim_additem
图片格式要求:JPG格式300 – 1200像素图片
请求方法 : POST
请求参数(body) :
参数名 | 类型 | 必填 | 参数位置 | 描述 | 默认值 |
---|---|---|---|---|---|
apikey | string | 是 | body | API密钥 | 无 |
imgname | string | 是 | body | 图片的名字. 必需唯一. 请使用由字母, 数字或-及_组成的图片名. 不要使用中文图片名. | 无 |
catid | int | 否 | body | 类别ID (1 – 30000 整数) | 无 |
lang | String | 否 | body | 返回语言: zh 中文; en 英文 | zh 中文 |
fmt | String | 否 | body | 返回结果格式: json或xml | json |
kwds | String | 否 | body | 输入关键词, 用来进行图片+关键词混合搜索. 关键词用逗号分开. 例子: 宠物,蓝天 | 无 |
labels | String | 否 | body | 输入图片正整数标签, 用逗号分开. 例子: 65,58,408 | 无 |
title | String | 否 | body | 输入图片标题文字. 例子: 小狗与草坪 | 无 |
info | String | 否 | body | 用户可将图片相关信息添于此. 搜索结果返回此信息. | 无 |
参数名 | 类型 | 必填 | 参数位置 | 描述 | 默认值 |
---|---|---|---|---|---|
photo | file | 是 | body | 图片文件 | 无 |
接口地址 :
http://apisim20.wozhitu.com:8084/vsearchtech/api/v1.0/apisim_additem
图片格式要求: JPG格式300 – 1200像素图片
请求方法 : POST
请求参数(body) :
参数名 | 类型 | 必填 | 参数位置 | 描述 | 默认值 |
---|---|---|---|---|---|
apikey | string | 是 | body | API密钥 | 无 |
imgname | string | 是 | body | 图片的名字. 必需唯一. 请使用由字母, 数字或-及_组成的图片名. 不要使用中文图片名. | 无 |
imgurl | string | 是 | body | 图片地址URL | 无 |
catid | int | 否 | body | 类别ID (1 – 30000 整数) | 无 |
lang | String | 否 | body | 返回语言: zh 中文; en 英文 | zh 中文 |
fmt | String | 否 | body | 返回结果格式: json或xml | json |
kwds | String | 否 | body | 输入关键词, 用来进行图片+关键词混合搜索. 关键词用逗号分开. 例子: 宠物,蓝天 | 无 |
labels | String | 否 | body | 输入图片正整数标签, 用逗号分开. 例子: 65,58,408 | 无 |
title | String | 否 | body | 输入图片标题文字. 例子: 小狗与草坪 | 无 |
info | String | 否 | body | 用户可将图片相关信息添于此. 搜索结果返回此信息. | 无 |
接口地址 :
http://apisim20.wozhitu.com:8084/vsearchtech/api/v1.0/apisim_deleteitem
请求方法 : POST
请求参数(body)
:
参数名 | 类型 | 必填 | 参数位置 | 描述 | 默认值 |
---|---|---|---|---|---|
apikey | string | 是 | body | API密钥 | 无 |
imgname | string | 是 | body | 图片的名字. 必需唯一. 请使用由字母, 数字或-及_组成的图片名. 不要使用中文图片名. | 无 |
fmt | string | 是 | body | 返回结果格式: json或xml | json |
接口地址 :
http://apisim20.wozhitu.com:8084/vsearchtech/api/v1.0/apisim_detail
请求方法 : POST 或 GET
请求参数(body/header) :
参数名 | 类型 | 必填 | 参数位置 | 描述 | 默认值 |
---|---|---|---|---|---|
apikey | string | 是 | body/header | API密钥 | 无 |
imgname | string | 是 | body/header | 图片的名字. 必需唯一. 请使用由字母, 数字或-及_组成的图片名. 不要使用中文图片名. | 无 |
fmt | string | 是 | body/header | 返回结果格式: json或xml | json |
接口地址 :http://apisim20.wozhitu.com:8084/vsearchtech/api/v1.0/apipnp_browse
图片格式要求: JPG格式,图像长及宽约300 – 800 像素图片
请求方法 : POST 或 GET
请求参数(body/header) :
参数名 | 类型 | 必填 | 参数位置 | 描述 | 默认值 |
---|---|---|---|---|---|
apikey | string | 是 | body/header | API密钥 | 无 |
catid | int | 否 | body/header | 类别ID (0 – 30000 整数) | 0 (即搜索所有类别) |
lang | string | 否 | body/header | 返回语言: zh 中文; en 英文 | zh 中文 |
fmt | string | 否 | body/header | 返回结果格式: json或xml | json |
subject | string | 否 | body/header | 用输入关键词进行图片搜索 | 无 |
labeland | string | 否 | body/header | 输入图片标签,正整数, 用AND逻辑标签筛选. 例子: 65,58,408 | 无 |
labelor | string | 否 | body/header | 输入图片标签,正整数, 用OR逻辑标签筛选. 例子: 305,38,5 | 无 |
labelnot | string | 否 | body/header | 输入图片标签,正整数,用NOT逻辑标签筛选. 例子: 345,368,45 | 无 |
p | string | 否 | body/header | 流览显示第p页面, p 为大于或等于1正整数 | 1 |
numperpage | string | 否 | body/header | 每页流览显示多少个, 应为正整数 | 16 |
maxitems | string | 否 | body/header | 最多一共流览显示多少个, 应为正整数 | 200 |
{ resultList":[{"class":"vs.vscommon.ImageSearchResultEntry", "imgName":"1392125321.jpg","imgRelativePath": "0_All/41_xyz/0_All_Categories/227_e2/1392125321.jpg", "imgUrl":"http://www.xyz.cn/images/front/v/pic2/e2/04/1392125321.jpg","info":null,"keyword": "Study,Signature,5美分硬币,办公室,笔记本","productPageUrl": "http://www.xyz.cn/r/photo/view/id/1392125321/","score":0.9785203,"tagsList": null,"title":"Gold pen signing contract"},{"class":"vs.vscommon.ImageSearchResultEntry", "imgName":"1204325791.jpg","imgRelativePath":"0_All/41_xyz/0_All_Categories/53_34/1204325791.jpg", "imgUrl":"http://www.xyz.cn/images/front/v/pic2/34/ce/1204325791.jpg","info":null,"keyword": "白色,比例,局部,动物","productPageUrl":"http://www.xyz.cn/r/photo/view/id/1204325791/","score": 0.978022,"tagsList":null,"title":"Small fish in glass of water isolated"} ]}
API_CODE_ERROR_exceeded_access_total | 用户总调用量超限 |
API_CODE_ERROR_exceeded_access_frequency | 用户调用频度超限 |
API_CODE_ERROR_exceeded_access_frequency_min | 服务每分钟调用量超限 |
API_CODE_ERROR_exceeded_access_frequency_hr | 服务每小时调用量超限 |
API_CODE_ERROR_exceeded_access_frequency_day | 用户日调用量超限 |
API_CODE_ERROR_exceeded_access_frequency_month | 服务每月调用量超限 |
API_CODE_ERROR_two_API_calls_time_too_close | 两次调用时间太近 |
IMAGE_INDEX_CODE_ERROR_IMAGE_EXCEED_MAX_DOCS_PER_UID | 用户添加图像量超限 |
API_CODE_ERROR_not_allow_write_index | 用户添加图像功能暂停(服务器很可能在维护中) |
API_CODE_ERROR_invalid_apikey | Apikey错误 |
IMAGE_INDEX_ITEM_CODE_ERROR_INVALID_imgName | 图片名错误 |
IMAGE_INDEX_ITEM_CODE_ERROR_INVALID_imgUrl | 图片URL错误 |
IMAGE_INDEX_ITEM_CODE_ERROR_INVALID_catid_must_be_1_to_30000 | 图片类别错误(应是1-30000整数) |
IMAGE_INDEX_ITEM_CODE_ERROR_INVALID_labels_must_be_positive_integer | 标签错误(应是正整数) |
IMAGE_INDEX_ITEM_CODE_ERROR_INVALID_FIELDS_any_field_must_not_have_double_quote | 图片数据错误, 不应有双引号 |
IMAGE_INDEX_ITEM_CODE_ERROR_INVALID_LANG | 语言参数错误(中文zh 或英语en) |
IMAGE_INDEX_CODE_ERROR_DOWNLOAD_IMAGE | 下载图片错误 |
IMAGE_INDEX_CODE_ERROR_IMAGE_SIZE_TOO_BIG | 图片太大(最好在400 – 800PIX JPG 图片) |
IMAGE_INDEX_DELETE_IMG_CODE_ERROR_NOT_FOUND_ITEM | 删除图片错误, 没找到图片 |