重复相同图片或近相同图片探测API服务

服务简介 :

本服务提供基于图像内容的相同图片或近相同图片探测搜索. 即用输入图片本身的颜色分布, 几何形状, 纹理来搜索重复的相同或近相同图片, 搜索结果按与输入图片的相似度打分排序. 服务调用者可用结果图片的相似度分数score判断是否为重复相同图片或近相同图片.


重复相同图片或近相同图片探测引擎关键功能列表:

海量图像 可轻松处理百万到千万量级图片
搜索速度快 50毫秒 – 500毫秒搜索响应速度
动态添加,修改,删除图片 可通过调用API动态添加, 修改,删除图片. 图片添加成功后可立即搜索.

应用场景 :

图像库交易平台, 电子商务网站或平台, 电子商务手机APP, 图片交易平台, 图片素材网站



接口地址 : http://apisim20.wozhitu.com:8084/vsearchtech/api/v1.0/apidup_search

图片格式要求: JPG格式,图像长及宽约300 – 800像素图片

请求方法 : POST

请求参数(body) :

参数名 类型 必填 参数位置 描述 默认值
apikey string body API密钥
fmt string body 返回结果格式: json或xml json
minscore float body 搜索结果图片与输入图片的最小相似度. 例如1.0 为100%相似, 0.95为95%相似. 0.90

请求参数(body) :

参数名 类型 必填 参数位置 描述 默认值
photo file body 图片文件


详细使用教程



接口地址 : http://apisim20.wozhitu.com:8084/vsearchtech/api/v1.0/apidup_search

图片格式要求: JPG格式300 – 800像素图片

请求方法 : POST

请求参数(body) :

参数名 类型 必填 参数位置 描述 默认值
apikey string body API密钥
imgurl string body 图片地址URL
fmt string body 返回结果格式: json或xml json
minscore float body 搜索结果图片与输入图片的最小相似度. 例如1.0 为100%相似, 0.95为95%相似. 0.90


接口地址 : http://apisim20.wozhitu.com:8084/vsearchtech/api/v1.0/apidup_additem

图片格式要求:JPG格式300 – 1200像素图片

请求方法 : POST

请求参数(body) :

参数名 类型 必填 参数位置 描述 默认值
apikey string body API密钥
imgname string body 图片的名字. 必需唯一. 请使用由字母, 数字或-及_组成的图片名. 不要使用中文图片名.
fmt String body 返回结果格式: json或xml json

参数名 类型 必填 参数位置 描述 默认值
photo file body 图片文件


详细使用教程

接口地址 : http://apisim20.wozhitu.com:8084/vsearchtech/api/v1.0/apidup_additem

图片格式要求: JPG格式300 – 1200像素图片

请求方法 : POST

请求参数(body) :

参数名 类型 必填 参数位置 描述 默认值
apikey string body API密钥
imgname string body 图片的名字. 必需唯一. 请使用由字母, 数字或-及_组成的图片名. 不要使用中文图片名.
imgurl string body 图片地址URL
fmt String body 返回结果格式: json或xml json


接口地址 : http://apisim20.wozhitu.com:8084/vsearchtech/api/v1.0/apidup_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/apidup_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"} ]}



错误码参照:


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