相似图像搜索与推荐API服务

服务简介 :

本服务提供基于图像内容的相似图像搜索. 即用输入图片本身的颜色分布, 几何形状, 纹理来搜索相似图片, 并将结果按与输入图片的相似度打分排序.


相似图像搜索与推荐引擎关键功能列表:

海量图像 可轻松处理百万到千万量级图片
搜索速度快 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 (1 – 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 图片文件


详细使用教程


JSON返回示例 :

{ 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 (1 – 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




JSON返回示例 :

{ 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 (1 – 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



JSON返回示例 :

{ 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"} ]}



下载Java相关资源
下载Python相关资源
下载Php相关资源

错误码参照:


限制类错误:
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 删除图片错误, 没找到图片