什么的脚| 剪不断理还乱什么意思| 午时右眼跳是什么预兆| 女性尿特别黄是什么原因| 吃什么吐什么| cmc是什么| 骨质增生是什么意思| 感冒嗓子疼吃什么消炎药| 泌乳素高有什么症状| 明天是什么节日| 急性扁桃体炎吃什么药| 什么人容易得心梗| 宫缩什么感觉| 啤酒是什么味道| 什么颜色最防晒| 文曲星下凡是什么意思| 儿女情长英雄气短是什么意思| 讥讽的笑是什么笑| tsh代表什么| 梵高是什么画派| 乳房胀痛挂什么科| 什么叫柏拉图式的爱情| 糖化高是什么意思| 协调什么意思| 主动脉增宽是什么意思| 灰紫色是什么颜色| 指甲硬是什么原因| 做梦梦见蛇是什么征兆| 怕金病帕金森是什么症状| 血虚吃什么中成药| 漉是什么意思| 取痣用什么方法最好| 1988年出生是什么命| 黑马比喻什么样的人| 尿多是什么原因男性| 小孩腿疼膝盖疼可能是什么原因| 己是什么意思| 颜字五行属什么| 病理单克隆抗体检测是什么| 甲申日是什么意思| 磨豆浆是什么意思| 99年属什么生肖| 吃无花果有什么好处| 陶渊明是什么朝代| 为什么耳鸣| 眼压高滴什么眼药水| lucas是什么意思| 1221是什么星座| 皮肤病是什么原因造成的| 男人小腹疼痛是什么原因| 身体缺钠会有什么症状| 吃什么补气血效果最好| 藕断丝连是什么意思| 拉什么| 敏感肌是什么| 骨裂吃什么药| 四两棉花歇后语是什么| 四面楚歌是什么生肖| 红曲粉是什么东西| 脉细滑是什么意思| 月经量少吃什么调理最好方法| 来月经有血块是什么原因| 经常梦遗是什么原因| 勿忘是什么意思| 什么叫腺样体肥大| 五香粉是什么| 不安腿是什么症状| 超度什么意思| 什么是同性恋| 什么是隐形矫正牙齿| 什么是贸易顺差| b超是什么| pe医学上是什么意思| 冰箱发烫是什么原因| 酸菜吃多了有什么危害| 铁扇公主是什么生肖| 苏打和小苏打有什么区别| 生物膜是什么| 女人吃洋葱有什么好处| 结婚的礼数都有什么| 幸灾乐祸什么意思| 针清是什么| 回声不均匀是什么意思| 为什么会得幽门螺旋杆菌| 女性尿道口有小疙瘩是什么原因| 土霉素主要是治疗什么病| 兔跟什么生肖配对最好| 骨皮质扭曲是什么意思啊| 绝对是什么意思| 静脉曲张挂号挂什么科| 阿托品是什么药| 黄丫头是什么鱼| 西安和咸阳什么关系| 旅行是什么意思| 体检前三天不能吃什么| 屁眼疼是什么原因| 米杏色是什么颜色| 男性阴虱用什么药最好| 棘突是什么意思| 养胃早餐吃什么好| 宝宝湿疹用什么药膏| 秋葵和什么不能一起吃| 开诚布公什么意思| 膝关节退行性改变是什么意思| 过敏了吃什么药好| 中暑什么症状| 鲤鱼打挺是什么意思| 焦虑会引起什么症状| 同房子宫疼痛什么原因| 等闲变却故人心却道故人心易变什么意思| 转肽酶高是什么原因| 慢性荨麻疹是什么原因引起的| 鹿晗的粉丝名叫什么| 麾下什么意思| 活好的女人有什么表现| 吃海鲜喝什么酒| 看肺结节挂什么科| 九月八号什么星座| 左肺纤维灶什么意思| 狭鳕鱼是什么鱼| bitch是什么意思| 抑郁症看什么科| 海绵体修复吃什么药| 改善记忆力吃什么药好| 后援会是什么意思| 浮夸是什么意思| 218号是什么星座| 白事的礼金叫什么| 为什么得带状疱疹| 吃什么补血效果最好| 冷暴力是什么| 不怕流氓什么就怕流氓有文化| 青海有什么特产| 脚气是什么样的图片| 开胸手术吃什么补元气| 尿频尿急吃什么药比较好| 肾结石是因什么而起| 黑户什么意思| 婴儿头发长得慢是什么原因| 双的反义词是什么| 州和洲有什么区别| 爱情是什么样| 属虎和什么属相相冲| 感冒喉咙痛吃什么药| 新生儿满月打什么疫苗| 唐筛是检查什么的| 什么是蜂胶| 胃反酸吃什么药| 感冒是什么原因引起的| horns是什么意思| 女人40不惑什么意思| 荷叶搭配什么一起喝减肥效果好| 低烧是什么症状和感觉| 80分贝相当于什么声音| 小猫不能吃什么食物| 惨烈是什么意思| 梦见知了猴是什么意思| 蚊子喜欢什么血型| 气血亏吃什么补的快| 肋骨骨折挂什么科| 火鸡是什么鸡| 试管婴儿是什么| 呼吸内镜检查什么| 海为什么是蓝色的| 意下如何什么意思| ochirly是什么牌子| 胡牌是什么意思| 狐惑病是什么病| 血小板计数偏高是什么意思| 单于是什么意思| 石敢当是什么神| 白细胞满视野是什么意思| 新生儿什么时候能看见东西| 二月二十三日是什么星座| 熬夜吃什么好| 贻笑大方什么意思| yesido是什么意思| 慢性阑尾炎吃什么药好| 小水母吃什么| af是什么| 手术后喝什么汤恢复快| 香茗是什么意思| 男属鸡的和什么属相最配| 荷叶像什么比喻句| 人这一生什么最重要| lamer是什么牌子| 1919年发生了什么| 女人脑供血不足吃什么| 纵隔肿瘤是什么病| 草字头一个见念什么| 淮山跟山药有什么区别| 宁字五行属什么| 孕妇喝什么汤最好最有营养| 五四运动的精神是什么| 什么饮料不含糖| 什么草| 下午四点到五点是什么时辰| 吃什么东西可以降压| 重症肌无力是什么病| qid是什么意思| 蛇的贵人是什么生肖| 洋葱什么时候种| 血气方刚什么意思| 头上长痘痘是什么原因| 七八年属什么| 射手座属于什么星象| 死有余辜是什么意思| 借力是什么意思| 左卵巢内囊性结构什么意思| 便秘吃什么药最好最快| 发低烧吃什么药| 梦见手机丢了又找到了是什么意思| 哺乳期妈妈感冒了可以吃什么药| 可不是什么意思| 关税什么意思| 碳酸饮料喝多了有什么危害| 2024年五行属什么| porridge什么意思| 罢黜百家独尊儒术是什么意思| 泄身是什么意思| 一什么书桌| 宝宝消化不良吃什么| 扁桃体割了对身体有什么影响| 方圆是什么意思| 心肌炎吃什么食物最好| 烧心是什么意思| 间接胆红素高是什么意思| 白化病是什么| 白带增多是什么原因| 瘤变是什么意思| 公招是什么意思| 月子吃什么最下奶| 不打自招是什么生肖| 云南的特产是什么| 下巴长痘痘是什么原因引起的| 儿童办理护照需要什么材料| 海参几头是什么意思| 尿比重高是什么原因| 化疗为什么要剃光头| 什么时候最容易受孕| bn是什么意思| 决裂是什么意思| 阴蒂痒是什么原因| 地狱不空誓不成佛是什么意思| 大疱病是什么病| 食字五行属什么| 吃什么败火| 什么的遗产| 草莽是什么意思| 以备不时之需什么意思| 草菅人命是什么意思| 日仄念什么| 阴道炎用什么洗| ih医学上是什么意思| 左眼跳什么右眼跳什么| 霖五行属性是什么| 姓蔡的女孩起什么名字| 什么的海风| 为什么一直不怀孕是什么原因| 梭子蟹什么季节吃最好| 参商是什么意思| 懦弱的近义词是什么| 梦见自己生男孩是什么意思| 业力重是什么意思| 百度
资讯 文档
技术能力
语音技术
文字识别
人脸与人体
图像技术
语言与知识
视频技术

小腹胀痛什么原因女性

相同图片搜索

在自建库中搜索相同图片,仅返回完全相同或局部相同的图片结果。

  • 典型应用场景:图片去重、图片精确查找,如图片类站点对海量库存图片进行查重过滤
  • 适用的图片类型:各种网络图片、实拍图均可;注意检索图和入库的原图要保持场景一致性,比如入库的原图为标准的广告图(无背景干扰),则检索图要尽量避免背景、其他干扰特征,否则模型计算图片的相似度时会有噪声,造成检索结果不准确。

举个例子:小张入库了5万张海报设计图,都是标准的电子版海报图片,无任何背景干扰;在线下活动时,要根据手机拍摄的海报图片判断是不是跟图库里的设计图重复了,手机实拍时要避免拍到海报图片之外的物体(如墙上的装饰、参加活动的人等各种背景元素),同时要拍到海报的全部或者大部分主体内容,不能只拍到一个海报的小角落就去检索,以免影响检索效果。

相同图片搜索包含入库、检索、删除、更新4个子接口;在正式使用之前请在控制台创建应用后,在应用详情页申请建库,建库成功后方可正常使用入库、检索、删除、更新接口

申请建库时,图库的图片数量上限为50万,避免浪费资源;如果容量不够用,可在控制台-应用详情页 申请扩容,工作人员会在1-3个工作日内审批,每次扩容的申请上限也是50万,可以反复申请扩容,原则上图库总量无上限,百万级、千万级、甚至亿级的图片量都可以做到实时检索,秒级返回检索结果。

相同图片搜索—入库

该接口实现单张图片入库,入库时需要同步提交图片及可关联至本地图库的摘要信息(具体变量为brief,具体可传入图片在本地标记id、图片url、图片名称等);同时可提交分类维度信息(具体变量为tags,最多可传入2个tag),方便对图库中的图片进行管理、分类检索。

注:重复添加完全相同的图片会返回错误

""" 读取图片 """
def get_file_content(filePath):
    with open(filePath, 'rb') as fp:
        return fp.read()

image = get_file_content('example.jpg')
brief = "{\"name\":\"周杰伦\", \"id\":\"666\"}"

""" 调用相同图检索—入库, 图片参数为本地图片 """
client.sameHqAdd(image, brief)

""" 如果有可选参数 """
options = {}
options["tags"] = "100,11"

""" 带参数调用相同图检索—入库, 图片参数为本地图片 """
client.sameHqAdd(image, brief, options)

url = "http//www.x.com/sample.jpg"

brief = "{\"name\":\"周杰伦\", \"id\":\"666\"}"

""" 调用相同图检索—入库, 图片参数为远程url图片 """
client.sameHqAddUrl(url, brief)

""" 如果有可选参数 """
options = {}
options["tags"] = "100,11"

""" 带参数调用相同图检索—入库, 图片参数为远程url图片 """
client.sameHqAddUrl(url, brief, options)

相同图片搜索—入库 请求参数详情

参数名称 是否必选 类型 说明
image string 图像数据,base64编码,要求base64编码后大小不超过4M,最短边至少50px,最长边最大4096px,支持jpg/png/bmp格式。重复添加完全相同的图片会返回错误,提示不能重复入库
url string 图片完整URL,URL长度不超过1024字节,URL对应的图片base64编码后大小不超过4M,当image字段存在时url字段失效
由于图床的差异性,抓图服务无法适配所有的图床,部分URL可能抓不到图,或者图片下载超时,遇到上述情况时请更换图片URL、或者将图片下载到本地转码后上传
brief string 检索时原样带回,最长256B。样例:{"name":"周杰伦", "id":"666"} 。请注意,检索接口不返回原图,仅返回入库时填写的brief信息,所以调用入库接口时,brief信息请尽量填写可关联至本地图库的图片id或者图片url、图片名称等信息
tags string 1 - 65535范围内的整数,tag间以逗号分隔,最多2个tag。样例:"100,11" ;检索时可圈定分类维度进行检索

相同图片搜索—入库 返回数据参数详情

字段 是否必选 类型 说明
log_id uint64 唯一的log id,用于问题定位
cont_sign string 输入图片的签名信息,请务必保存至本地,以便后续用作批量删除、查询某张图是否已经入过库等用途

相同图片搜索—入库 返回示例

{
    "log_id": 2263663554,
    "cont_sign": "4261577168,501945506"
}

相同图片搜索—检索

完成入库后,可使用该接口实现相同图检索。支持传入指定分类维度(具体变量tags)进行检索,返回结果支持翻页(具体变量pn、rn)

请注意,检索接口不返回原图,仅反馈入库时填写的brief信息,请调用入库接口时尽量填写可关联至本地图库的图片id或者图片url等信息

""" 读取图片 """
def get_file_content(filePath):
    with open(filePath, 'rb') as fp:
        return fp.read()

image = get_file_content('example.jpg')

""" 调用相同图片搜索—检索, 图片参数为本地图片 """
client.sameHqSearch(image)

""" 如果有可选参数 """
options = {}
options["tags"] = "100,11"
options["tag_logic"] = "0"
options["pn"] = "100"
options["rn"] = "250"

""" 带参数调用相同图片搜索—检索, 图片参数为本地图片 """
client.sameHqSearch(image, options)

url = "http//www.x.com/sample.jpg"

""" 调用相同图片搜索—检索, 图片参数为远程url图片 """
client.sameHqSearchUrl(url)

""" 如果有可选参数 """
options = {}
options["tags"] = "100,11"
options["tag_logic"] = "0"
options["pn"] = "100"
options["rn"] = "250"

""" 带参数调用相同图片搜索—检索, 图片参数为远程url图片 """
client.sameHqSearchUrl(url, options)

相同图片搜索—检索 请求参数详情

参数名称 是否必选 类型 说明
image string 图像数据,base64编码,要求base64编码后大小不超过4M,最短边至少50px,最长边最大4096px,支持jpg/png/bmp格式
url string 图片完整URL,URL长度不超过1024字节,当image字段存在时url字段失效
由于图床的差异性,抓图服务无法适配所有的图床,部分URL可能抓不到图,或者图片下载超时,遇到上述情况时请更换图片URL、或者将图片下载到本地转码后上传
tags string 1 - 65535范围内的整数,tag间以逗号分隔,最多2个tag。样例:"100,11" ;检索时可圈定分类维度进行检索
tag_logic string 检索时tag之间的逻辑, 0:逻辑and,1:逻辑or
pn string 分页功能,起始位置,例:0。未指定分页时,默认返回前300个结果;接口返回数量最大限制1000条,例如:起始位置为900,截取条数500条,接口也只返回第900 - 1000条的结果,共计100条
rn string 分页功能,截取条数,例:250

相同图片搜索—检索 返回数据参数详情

字段 是否必选 类型 说明
log_id uint64 唯一的log id,用于问题定位
result_num uint32 检索结果数
result object[] 结果数组
+cont_sign string 图片签名,可以用来删除图片或定位问题
+score float 图片相关性,取值范围0-1,越接近1表示越相关
+brief string 调用入库接口添加的brief信息,为保证该结果有效性,请入库时填写可关联至本地图片库的有效id信息
has_more bool 是否还有下一页,返回值:true、false;如果不分页,不用关注该字段

相同图片搜索—检索 返回示例

{
    "result_num": 1,
    "result": [
        {
            "score": 0.97976700290421,
            "brief": "./data/jay1.jpg",
            "cont_sign": "475124309,1080176642"
        }
    ],
    "log_id": 1968648150
}

相同图片搜索—更新

更新图库中图片的摘要和分类信息(具体变量为brief、tags)

""" 读取图片 """
def get_file_content(filePath):
    with open(filePath, 'rb') as fp:
        return fp.read()

image = get_file_content('example.jpg')

""" 调用相同图片搜索—更新, 图片参数为本地图片 """
client.sameHqUpdate(image)

""" 如果有可选参数 """
options = {}
options["brief"] = "{\"name\":\"周杰伦\", \"id\":\"666\"}"
options["tags"] = "100,11"

""" 带参数调用相同图片搜索—更新, 图片参数为本地图片 """
client.sameHqUpdate(image, options)

url = "http//www.x.com/sample.jpg"

""" 调用相同图片搜索—更新, 图片参数为远程url图片 """
client.sameHqUpdateUrl(url)

""" 如果有可选参数 """
options = {}
options["brief"] = "{\"name\":\"周杰伦\", \"id\":\"666\"}"
options["tags"] = "100,11"

""" 带参数调用相同图片搜索—更新, 图片参数为远程url图片 """
client.sameHqUpdateUrl(url, options)

contSign = "8cnn32frvrr2cd901"

""" 调用相同图片搜索—更新, 图片参数为图片签名 """
client.sameHqUpdateContSign(contSign)

""" 如果有可选参数 """
options = {}
options["brief"] = "{\"name\":\"周杰伦\", \"id\":\"666\"}"
options["tags"] = "100,11"

""" 带参数调用相同图片搜索—更新, 图片参数为图片签名 """
client.sameHqUpdateContSign(contSign, options)

相同图片搜索—更新 请求参数详情

参数名称 是否必选 类型 说明
image string 图像数据,base64编码,要求base64编码后大小不超过4M,最短边至少50px,最长边最大4096px;支持jpg/png/bmp格式。和url、cont_sign三选一,优先级:image > url > cont_sign
url string 图片完整URL,URL长度不超过1024字节,当image字段存在时url字段失效
cont_sign string 图片签名。和image、url三选一,优先级:image > url > cont_sign;不支持批量传入签名
brief string 更新的摘要信息,最长256B。样例:{"name":"周杰伦", "id":"666"}
tags string 1 - 65535范围内的整数,tag间以逗号分隔,最多2个tag。样例:"100,11" ;检索时可圈定分类维度进行检索

相同图片搜索—更新 返回数据参数详情

字段 是否必选 类型 说明
log_id uint64 唯一的log id,用于问题定位

相同图片搜索—更新 返回示例

{
    "log_id": 2263663554
}

相同图片搜索—删除

删除图库中的图片,支持批量删除,批量删除时请传cont_sign参数,勿传image,最多支持100个cont_sign

""" 读取图片 """
def get_file_content(filePath):
    with open(filePath, 'rb') as fp:
        return fp.read()

image = get_file_content('example.jpg')

""" 调用删除相同图,传入参数为图片 """
client.sameHqDeleteByImage(image)

url = "http//www.x.com/sample.jpg"

""" 调用删除相同图,图片参数为远程url图片 """
client.sameHqDeleteByUrl(url)

contSign = "8cnn32frvrr2cd901"

""" 调用删除相同图,传入参数为图片签名 """
client.sameHqDeleteBySign(contSign)

相同图片搜索—删除 请求参数详情

参数名称 是否必选 类型 说明
image string 图像数据,base64编码,要求base64编码后大小不超过4M,最短边至少50px,最长边最大4096px,支持jpg/png/bmp格式
url string 图片完整URL,URL长度不超过1024字节,URL对应的图片base64编码后大小不超过4M,最短边至少50px,最长边最大4096px,支持jpg/png/bmp格式,当image字段存在时url字段失效
cont_sign string 图片签名(和image、url三选一),支持批量删除,批量删除时请勿传image、url,最多支持100个cont_sign列表,样例:"932301884,1068006219;316336521,553141152;2491030726,1352091083"

相同图片搜索—删除 返回数据参数详情

参数 类型 是否必须 说明 示例
log_id number 请求标识码,随机数,唯一 507499361

相同图片搜索—删除 返回示例

{
  "log_id": 50488417
}

相似图片搜索

在自建图库中找到与检索图片语义相似的图片集,并给出相似度打分(综合图片类型、颜色、内容、布局等特征)

  • 典型应用场景:找相似的图片集合(返回的结果包含相同的图片),各种设计素材、美术作品、UGC内容等
  • 适用的图片类型:各种网络图片、实拍图均可;注意检索图和入库的原图要尽量保持场景一致性,比如入库的原图为标准的广告图(无背景干扰),则检索图要尽量避免背景、其他干扰特征,否则模型计算图片的相似度时会有噪声,造成检索结果不准确。

相似图片搜索包含入库、检索、删除、更新4个子接口;在正式使用之前请在控制台创建应用后,在应用详情页申请建库,建库成功后方可正常使用入库、检索、删除、更新接口。

申请建库时,图库的图片数量上限为50万,避免浪费资源;如果容量不够用,可在控制台-应用详情页 申请扩容,工作人员会在1-3个工作日内审批,每次扩容的申请上限也是50万,可以反复申请扩容,原则上图库总量无上限,百万级、千万级、甚至亿级的图片量都可以做到实时检索,秒级返回检索结果。

相似图片搜索—入库

该接口实现单张图片入库,入库时需要同步提交图片及可关联至本地图库的摘要信息(具体变量为brief,具体可传入图片在本地标记id、图片url、图片名称等);同时可提交分类维度信息(具体变量为tags,最多可传入2个tag),方便对图库中的图片进行管理、分类检索。

注:重复添加完全相同的图片会返回错误

""" 读取图片 """
def get_file_content(filePath):
    with open(filePath, 'rb') as fp:
        return fp.read()

image = get_file_content('example.jpg')
brief = "{\"name\":\"周杰伦\", \"id\":\"666\"}"

""" 调用相似图检索—入库, 图片参数为本地图片 """
client.similarAdd(image, brief)

""" 如果有可选参数 """
options = {}
options["tags"] = "100,11"

""" 带参数调用相似图检索—入库, 图片参数为本地图片 """
client.similarAdd(image, brief, options)

url = "http//www.x.com/sample.jpg"

brief = "{\"name\":\"周杰伦\", \"id\":\"666\"}"

""" 调用相似图检索—入库, 图片参数为远程url图片 """
client.similarAddUrl(url, brief)

""" 如果有可选参数 """
options = {}
options["tags"] = "100,11"

""" 带参数调用相似图检索—入库, 图片参数为远程url图片 """
client.similarAddUrl(url, brief, options)

相似图片搜索—入库 请求参数详情

参数名称 是否必选 类型 说明
image string 图像数据,base64编码,要求base64编码后大小不超过4M,最短边至少50px,最长边最大4096px,支持jpg/png/bmp格式。重复添加完全相同的图片会返回错误,提示不能重复入库。
url string 图片完整URL,URL长度不超过1024字节,URL对应的图片base64编码后大小不超过4M,最短边至少50px,最长边最大4096px,支持jpg/png/bmp格式,当image字段存在时url字段失效
由于图床的差异性,抓图服务无法适配所有的图床,部分URL可能抓不到图,或者图片下载超时,遇到上述情况时请更换图片URL、或者将图片下载到本地转码后上传
brief string 检索时原样带回,最长256B。样例:{"name":"周杰伦", "id":"666"} 。请注意,检索接口不返回原图,仅返回入库时填写的brief信息,所以调用该入库接口时,brief信息请尽量填写可关联至本地图库的图片id或者图片url、图片名称等信息
tags string 1 - 65535范围内的整数,tag间以逗号分隔,最多2个tag。样例:"100,11" ;检索时可圈定分类维度进行检索

相似图片搜索—入库 返回数据参数详情

字段 是否必选 类型 说明
log_id uint64 唯一的log id,用于问题定位
cont_sign string 输入图片的签名信息,请务必保存至本地,以便后续用作批量删除、查询某张图是否已经入过库等用途

相似图片搜索—入库 返回示例

{
    "log_id": 2263663554,
    "cont_sign": "4261577168,501945506"
}

入库之后的图片,可在控制台的图库管理后台进行可视化管理,支持预览大图、更新摘要、更新分类信息、删除图片,入口在控制台-应用详情页 管理图库,注:大批量更新摘要或分类、删除图片请调用API。

同时,图库管理后台支持在线测试检索效果,点击右上角搜索框边上的“相机”标识,可以上传图片,测试检索效果。

相似图片搜索—检索

完成入库后,可使用该接口实现相似图检索。支持传入指定分类维度(具体变量tags)进行检索,返回结果支持翻页(具体变量pn、rn)

注意:
1、检索接口不返回原图,仅反馈入库时填写的brief信息,请调用入库接口时尽量填写可关联至本地图库的图片id或者图片url等信息。

2、检索接口默认返回TOP 300的结果,如果图库里不满300张图片,会返回所有图片,请入库足量图片以便充分测试效果

3、原则上任何2张图片都有相似度,只不过分值有高低,应用时可结合接口返回的相关性分数score(取值范围0-1,越接近1代表相似度越高)进行筛选,如选取score大于某个值的结果进行应用

""" 读取图片 """
def get_file_content(filePath):
    with open(filePath, 'rb') as fp:
        return fp.read()

image = get_file_content('example.jpg')

""" 调用相似图片搜索—检索, 图片参数为本地图片 """
client.similarSearch(image)

""" 如果有可选参数 """
options = {}
options["tags"] = "100,11"
options["tag_logic"] = "0"
options["pn"] = "100"
options["rn"] = "250"

""" 带参数调用相似图片搜索—检索, 图片参数为本地图片 """
client.similarSearch(image, options)

url = "http//www.x.com/sample.jpg"

""" 调用相似图片搜索—检索, 图片参数为远程url图片 """
client.similarSearchUrl(url)

""" 如果有可选参数 """
options = {}
options["tags"] = "100,11"
options["tag_logic"] = "0"
options["pn"] = "100"
options["rn"] = "250"

""" 带参数调用相似图片搜索—检索, 图片参数为远程url图片 """
client.similarSearchUrl(url, options)

相似图片搜索—检索 请求参数详情

参数名称 是否必选 类型 说明
image string 图像数据,base64编码,要求base64编码后大小不超过4M,最短边至少50px,最长边最大4096px,支持jpg/png/bmp格式
url string 图片完整URL,URL长度不超过1024字节,URL对应的图片base64编码后大小不超过4M,最短边至少50px,最长边最大4096px,支持jpg/png/bmp格式,当image字段存在时url字段失效
由于图床的差异性,抓图服务无法适配所有的图床,部分URL可能抓不到图,或者图片下载超时,遇到上述情况时请更换图片URL、或者将图片下载到本地转码后上传
tags string 1 - 65535范围内的整数,tag间以逗号分隔,最多2个tag。样例:"100,11" ;检索时可圈定分类维度进行检索
tag_logic string 检索时tag之间的逻辑, 0:逻辑and,1:逻辑or
pn string 分页功能,起始位置,例:0。未指定分页时,默认返回前300个结果;接口返回数量最大限制1000条,例如:起始位置为900,截取条数500条,接口也只返回第900 - 1000条的结果,共计100条
rn string 分页功能,截取条数,例:250

相似图片搜索—检索 返回数据参数详情

字段 是否必选 类型 说明
log_id uint64 唯一的log id,用于问题定位
result_num uint32 检索结果数
result object[] 结果数组
+cont_sign string 图片签名,可以用来删除图片或定位问题
+score float 图片相关性,取值范围0-1,越接近1代表越相似
+brief string 入库时添加的brief信息
has_more bool 是否还有下一页,返回值:true、false;如果不分页,不用关注该字段

相似图片搜索—检索 返回示例

{
    "result_num": 1,
    "result": [
        {
            "score": 0.97976700290421,
            "brief": "./data/jay1.jpg",
            "cont_sign": "475124309,1080176642"
        }
    ],
    "log_id": 1968648150
}

相似图片搜索—更新

更新图库中图片的摘要和分类信息(具体变量为brief、tags)

""" 读取图片 """
def get_file_content(filePath):
    with open(filePath, 'rb') as fp:
        return fp.read()

image = get_file_content('example.jpg')

""" 调用相似图片搜索—更新, 图片参数为本地图片 """
client.similarUpdate(image)

""" 如果有可选参数 """
options = {}
options["brief"] = "{\"name\":\"周杰伦\", \"id\":\"666\"}"
options["tags"] = "100,11"

""" 带参数调用相似图片搜索—更新, 图片参数为本地图片 """
client.similarUpdate(image, options)

url = "http//www.x.com/sample.jpg"

""" 调用相似图片搜索—更新, 图片参数为远程url图片 """
client.similarUpdateUrl(url)

""" 如果有可选参数 """
options = {}
options["brief"] = "{\"name\":\"周杰伦\", \"id\":\"666\"}"
options["tags"] = "100,11"

""" 带参数调用相似图片搜索—更新, 图片参数为远程url图片 """
client.similarUpdateUrl(url, options)

contSign = "8cnn32frvrr2cd901"

""" 调用相似图片搜索—更新, 图片参数为图片签名 """
client.similarUpdateContSign(contSign);

""" 如果有可选参数 """
options = {}
options["brief"] = "{\"name\":\"周杰伦\", \"id\":\"666\"}"
options["tags"] = "100,11"

""" 带参数调用相似图片搜索—更新, 图片参数为图片签名 """
client.similarUpdateContSign(contSign, options)

相似图片搜索—更新 请求参数详情

参数名称 是否必选 类型 说明
image string 图像数据,base64编码,要求base64编码后大小不超过4M,最短边至少15px,最长边最大4096px,支持jpg/png/bmp格式。和url、cont_sign三选一,优先级:image > url > cont_sign
url string 图片完整URL,URL长度不超过1024字节,URL对应的图片base64编码后大小不超过4M,最短边至少15px,最长边最大4096px,支持jpg/png/bmp格式,当image字段存在时url字段失效
cont_sign string 图片签名,和image、url三选一,优先级:image > url > cont_sign;不支持批量传入签名
brief string 更新的摘要信息,最长256B。样例:{"name":"周杰伦", "id":"666"}
tags string 1 - 65535范围内的整数,tag间以逗号分隔,最多2个tag。样例:"100,11" ;检索时可圈定分类维度进行检索

相似图片搜索—更新 返回数据参数详情

字段 是否必选 类型 说明
log_id uint64 唯一的log id,用于问题定位

相似图片搜索—更新 返回示例

{
    "log_id": 2263663554
}

相似图片搜索—删除

删除图库中的图片,支持批量删除,批量删除时请传cont_sign参数,勿传image,最多支持100个cont_sign

""" 读取图片 """
def get_file_content(filePath):
    with open(filePath, 'rb') as fp:
        return fp.read()

image = get_file_content('example.jpg')

""" 调用删除相似图,传入参数为图片 """
client.similarDeleteByImage(image)

url = "http//www.x.com/sample.jpg"

""" 调用删除相似图,图片参数为远程url图片 """
client.similarDeleteByUrl(url)

contSign = "8cnn32frvrr2cd901"

""" 调用删除相似图,传入参数为图片签名 """
client.similarDeleteBySign(contSign)

相似图片搜索—删除 请求参数详情

参数名称 是否必选 类型 说明
image string 图像数据,base64编码 。和url、cont_sign三选一,优先级:image > url > cont_sign
url string 图片完整URL,URL长度不超过1024字节,当image字段存在时url字段失效
cont_sign string 图片签名(和image、url三选一),支持批量删除,批量删除时请勿传image、url,最多支持100个cont_sign列表。样例:"932301884,1068006219;316336521,553141152;2491030726,1352091083"

相似图片搜索—删除 返回数据参数详情

参数 类型 是否必须 说明 示例
log_id number 请求标识码,随机数,唯一 507499361

相似图检索—删除 返回示例

{
      "log_id": 50488417
}

商品图片搜索

针对商品类图片,专项训练检索模型,在自建图库中搜索相同及相似的商品图片集,可找到不同颜色、背景、角度的同款商品。

  • 典型应用场景:各类B2B、B2C电商平台,相似商品推荐、拍照搜同款或者相似商品
  • 适用的图片类型:电商商品图片(实体商品为主,如数码3C、服装鞋帽、日化百货等)

注意:部分特殊商品,如面料、木材、瓷砖等,建议同步对比测试相似图搜索的效果,择优使用

商品图片搜索包含入库、检索、删除、更新4个子接口;在正式使用之前请在控制台创建应用后,在应用详情页申请建库,建库成功后方可正常使用入库、检索、删除、更新接口

申请建库时,图库的图片数量上限为50万,避免浪费资源;如果容量不够用,可在控制台-应用详情页 申请扩容,工作人员会在1-3个工作日内审批,每次扩容的申请上限也是50万,可以反复申请扩容,原则上图库总量无上限,百万级、千万级、甚至亿级的图片量都可以做到实时检索,秒级返回检索结果。

商品图片搜索—入库

该接口实现单张图片入库,入库时需要同步提交图片及可关联至本地图库的摘要信息(具体变量为brief,具体可传入图片在本地标记id、图片url、图片名称等)。同时可提交分类维度信息(具体变量为class_id1、class_id2),方便对图库中的图片进行管理、分类检索。

注:重复添加完全相同的图片会返回错误

""" 读取图片 """
def get_file_content(filePath):
    with open(filePath, 'rb') as fp:
        return fp.read()

image = get_file_content('example.jpg')
brief = "{\"name\":\"手机\", \"id\":\"666\"}"

""" 调用商品检索—入库, 图片参数为本地图片 """
client.productAdd(image, brief)

""" 如果有可选参数 """
options = {}
options["class_id1"] = 1
options["class_id2"] = 1

""" 带参数调用商品检索—入库, 图片参数为本地图片 """
client.productAdd(image, brief, options)

url = "http//www.x.com/sample.jpg"

brief = "{\"name\":\"手机\", \"id\":\"666\"}"

""" 调用商品检索—入库, 图片参数为远程url图片 """
client.productAddUrl(url, brief)

""" 如果有可选参数 """
options = {}
options["class_id1"] = 1
options["class_id2"] = 1

""" 带参数调用商品检索—入库, 图片参数为远程url图片 """
client.productAddUrl(url, brief, options)

商品图片搜索—入库 请求参数详情

参数名称 是否必选 类型 说明
image string 图像数据,base64编码后进行urlencode,要求base64编码和urlencode后大小不超过4M。和url二选一,image优先级更高,最短边至少300px,最长边最大4096px,支持jpg/png/bmp格式。重复添加会返回错误。
url string 图片完整URL,URL长度不超过1024字节,URL对应的图片base64编码后大小不超过4M,最短边至少300px,最长边最大4096px,支持jpg/png/bmp格式,当image字段存在时url字段失效
由于图床的差异性,抓图服务无法适配所有的图床,部分URL可能抓不到图,或者图片下载超时,遇到上述情况时请更换图片URL、或者将图片下载到本地转码后上传
brief string 检索时原样带回,最长256B。请注意,检索接口不返回原图,仅反馈当前填写的brief信息,所以调用该入库接口时,brief信息请尽量填写可关联至本地图库的图片id或者图片url、图片名称等信息
class_id1 string 商品分类维度1,支持1-60范围内的整数。检索时可圈定该分类维度进行检索
class_id2 string 商品分类维度1,支持1-60范围内的整数。检索时可圈定该分类维度进行检索

商品图片搜索—入库 返回数据参数详情

字段 是否必选 类型 说明
log_id uint64 唯一的log id,用于问题定位
cont_sign string 上传图片的签名信息,请务必保存至本地,以便后续用作批量删除、查询某张图是否已经入过库等用途

商品图片搜索—入库 返回示例

{
        "log_id": 2263663554,
        "cont_sign": "4261577168,501945506"
}

入库之后的图片,可在控制台的图库管理后台进行可视化管理,支持预览大图、更新摘要、更新分类信息、删除图片,入口在控制台-应用详情页 管理图库,注:大批量更新摘要或分类、删除图片请调用API。

同时,图库管理后台支持在线测试检索效果,点击右上角搜索框边上的“相机”标识,可以上传图片,测试检索效果。

商品图片搜索—检索

完成入库后,可使用该接口实现相似商品图片检索。支持传入指定分类维度(具体变量class_id1、class_id2)进行检索,返回结果支持翻页(具体变量pn、rn)

注意:
1、检索接口不返回原图,仅反馈入库时填写的brief信息,请调用入库接口时尽量填写可关联至本地图库的图片id或者图片url等信息。

2、检索接口默认返回TOP 300的结果,如果图库里不满300张图片,会返回所有图片,请入库足量图片以便充分测试效果

3、原则上任何2张图片都有相似度,只不过分值有高低,应用时可结合接口返回的相关性分数score(取值范围0-1,越接近1代表相似度越高)进行筛选,如选取score大于某个值的结果进行应用

    """ 读取图片 """
    def get_file_content(filePath):
        with open(filePath, 'rb') as fp:
            return fp.read()

    image = get_file_content('example.jpg')

    """ 调用商品图片搜索—检索, 图片参数为本地图片 """
    client.productSearch(image)

    """ 如果有可选参数 """
    options = {}
    options["class_id1"] = 1
    options["class_id2"] = 1
    options["pn"] = "100"
    options["rn"] = "250"

    """ 带参数调用商品图片搜索—检索, 图片参数为本地图片 """
    client.productSearch(image, options)

    url = "http//www.x.com/sample.jpg"

    """ 调用商品图片搜索—检索, 图片参数为远程url图片 """
    client.productSearchUrl(url)

    """ 如果有可选参数 """
    options = {}
    options["class_id1"] = 1
    options["class_id2"] = 1
    options["pn"] = "100"
    options["rn"] = "250"

    """ 带参数调用商品图片搜索—检索, 图片参数为远程url图片 """
    client.productSearchUrl(url, options)

商品图片搜索—检索 请求参数详情

参数名称 是否必选 类型 说明
image string 图像数据,base64编码,要求base64编码后大小不超过4M,最短边至少300px,最长边最大4096px,支持jpg/png/bmp格式 。和url二选一,image优先级更高
url string 图片完整URL,URL长度不超过1024字节,URL对应的图片base64编码后大小不超过4M,最短边至少300px,最长边最大4096px,支持jpg/png/bmp格式,当image字段存在时url字段失效
由于图床的差异性,抓图服务无法适配所有的图床,部分URL可能抓不到图,或者图片下载超时,遇到上述情况时请更换图片URL、或者将图片下载到本地转码后上传
class_id1 string 商品分类维度1,支持1-60范围内的整数。检索时可圈定该分类维度进行检索
class_id2 string 商品分类维度1,支持1-60范围内的整数。检索时可圈定该分类维度进行检索
pn string 分页功能,起始位置,例:0。未指定分页时,默认返回前300个结果;接口返回数量最大限制1000条,例如:起始位置为900,截取条数500条,接口也只返回第900 - 1000条的结果,共计100条
rn string 分页功能,截取条数,例:250

商品图片搜索—检索 返回数据参数详情

字段 是否必选 类型 说明
log_id uint64 唯一的log id,用于问题定位
result_num uint32 检索结果数
result object[] 结果数组
+cont_sign string 图片签名,可以用来删除图片或定位问题
+score float 图片相关性,取值范围0-1,越接近1代表越相似
+brief string 入库时添加的brief信息
has_more bool 是否还有下一页,返回值:true、false;如果不分页,不用关注该字段

商品图片搜索—检索 返回示例

    {
        "result_num": 1,
        "result": [
            {
                "score": 0.97976700290421,
                "brief": "./data/mobile.jpg",
                "cont_sign": "475124309,1080176642"
            }
        ],
        "log_id": 1968648150
    }

商品图片搜索—更新

更新图库中图片的摘要和分类信息(具体变量为brief、class_id1/class_id2).

    """ 读取图片 """
    def get_file_content(filePath):
        with open(filePath, 'rb') as fp:
            return fp.read()

    image = get_file_content('example.jpg')

    """ 调用商品图片搜索—更新, 图片参数为本地图片 """
    client.productUpdate(image)

    """ 如果有可选参数 """
    options = {}
    options["brief"] = "{\"name\":\"周杰伦\", \"id\":\"666\"}"
    options["class_id1"] = 1
    options["class_id2"] = 1

    """ 带参数调用商品图片搜索—更新, 图片参数为本地图片 """
    client.productUpdate(image, options)

    url = "http//www.x.com/sample.jpg"

    """ 调用商品图片搜索—更新, 图片参数为远程url图片 """
    client.productUpdateUrl(url)

    """ 如果有可选参数 """
    options = {}
    options["brief"] = "{\"name\":\"周杰伦\", \"id\":\"666\"}"
    options["class_id1"] = 1
    options["class_id2"] = 1

    """ 带参数调用商品图片搜索—更新, 图片参数为远程url图片 """
    client.productUpdateUrl(url, options)

商品图片搜索—更新 请求参数详情

参数名称 是否必选 类型 说明
image string 图像数据,base64编码,要求base64编码后大小不超过4M,最短边至少300px,最长边最大4096px,支持jpg/png/bmp格式。和url、cont_sign三选一,优先级:image > url > cont_sign
url string 图片完整URL,URL长度不超过1024字节,URL对应的图片base64编码后大小不超过4M,最短边至少300px,最长边最大4096px,支持jpg/png/bmp格式,当image字段存在时url字段失效
brief string 更新的摘要信息,最长256B。样例:{"name":"周杰伦", "id":"666"}
class_id1 string 更新的商品分类1,支持1-60范围内的整数。
class_id2 string 更新的商品分类2,支持1-60范围内的整数。

商品图片搜索—更新 返回数据参数详情

字段 是否必选 类型 说明
log_id uint64 唯一的log id,用于问题定位

商品图片搜索—更新 返回示例

    {
        "log_id": 2263663554
    }

商品图片搜索—删除

删除图库中的图片,支持批量删除,批量删除时请传cont_sign参数,勿传image,最多支持100个cont_sign

    """ 读取图片 """
    def get_file_content(filePath):
        with open(filePath, 'rb') as fp:
            return fp.read()

    image = get_file_content('example.jpg')

    """ 调用删除商品,传入参数为图片 """
    client.productDeleteByImage(image)

    url = "http//www.x.com/sample.jpg"

    """ 调用删除商品,图片参数为远程url图片 """
    client.productDeleteByUrl(url)

    contSign = "8cnn32frvrr2cd901"

    """ 调用删除商品,传入参数为图片签名 """
    client.productDeleteBySign(contSign)

商品图片搜索—删除 请求参数详情

参数名称 是否必选 类型 说明
image string 图像数据,base64编码,要求base64编码后大小不超过4M,最短边至少300px,最长边最大4096px;支持jpg/png/bmp格式。和url、cont_sign三选一,优先级:image > url > cont_sign
url string 图片完整URL,URL长度不超过1024字节,URL对应的图片base64编码后大小不超过4M,最短边至少300px,最长边最大4096px,支持jpg/png/bmp格式,当image字段存在时url字段失效
由于图床的差异性,抓图服务无法适配所有的图床,部分URL可能抓不到图,或者图片下载超时,遇到上述情况时请更换图片URL、或者将图片下载到本地转码后上传
cont_sign string 图片签名(和image、url三选一,优先级最低),支持批量删除,批量删除时请勿传image、url,最多支持100个cont_sign列表,样例:"932301884,1068006219;316336521,553141152;2491030726,1352091083"

商品图片搜索—删除 返回数据参数详情

参数 类型 是否必须 说明 示例
log_id number 请求标识码,随机数,唯一 507499361

商品图片搜索—删除 返回示例

    {
      "log_id": 50488417
    }

绘本图片搜索—入库

该接口实现单张图片入库,入库时需要同步提交图片及可关联至本地图库的摘要信息(具体变量为brief,具体可传入图片在本地标记id、图片url、图片名称等);同时可提交分类维度信息(具体变量为tags,最多可传入2个tag),方便对图库中的图片进行管理、分类检索。

注:重复添加完全相同的图片会返回错误

""" 读取图片 """
def get_file_content(filePath):
    with open(filePath, 'rb') as fp:
        return fp.read()

image = get_file_content('example.jpg')
brief = "{\"name\":\"周杰伦\", \"id\":\"666\"}"

""" 调用绘本图片搜索—入库, 图片参数为本地图片 """
client.pictureBookAddImage(image, brief)

""" 如果有可选参数 """
options = {}
options["tags"] = "100,11"

""" 带参数调用绘本图片搜索—入库, 图片参数为本地图片 """
client.pictureBookAddImage(image, brief, options)

url = "http//www.x.com/sample.jpg"

brief = "{\"name\":\"周杰伦\", \"id\":\"666\"}"

""" 调用绘本图片搜索—入库, 图片参数为远程url图片 """
client.pictureBookAddUrl(url, brief)

""" 如果有可选参数 """
options = {}
options["tags"] = "100,11"

""" 带参数调用绘本图片搜索—入库, 图片参数为远程url图片 """
client.pictureBookAddUrl(url, brief, options)

绘本图片搜索—入库 请求参数详情

参数 是否必选 类型 可选值范围 说明
image string - 图像数据,base64编码后进行urlencode,要求base64编码和urlencode后大小不超过4M。(和url二选一,image优先级更高),注意要去掉图片头部,如(data:image/jpg;base64,);最短边至少150px,最长边最大4096px,长宽比在1:10-10:1之间。支持jpg/png/bmp格式。重复添加完全相同的图片会返回错误,提示不能重复入库。
url string - 图片URL,和image二选一,image优先级更高,由于图床的差异性,抓图服务无法适配所有的图床,部分URL可能抓不到图,或者图片下载超时,遇到上述情况时请更换图片URL、或者将图片下载到本地转码后上传
brief string - 检索时原样带回,最长256B。样例:{"name":"周杰伦", "id":"666"} 。请注意,检索接口不返回原图,仅返回入库时填写的brief信息,所以调用入库接口时,brief信息请尽量填写可关联至本地图库的图片id或者图片url、图片名称等信息
tags string 1 - 65535范围内的整数 tag间以逗号分隔,最多2个tag,2个tag无层级关系,检索时支持逻辑运算。样例:"100,11" ;检索时可圈定分类维度进行检索

绘本图片搜索—入库 返回数据参数详情

字段 是否必选 类型 说明
log_id uint64 唯一的log id,无实际意义,用于问题定位
cont_sign string 入库图片的签名信息,请务必保存至本地,以便后续用作批量删除、查询某张图是否已经入过库等用途

绘本图片搜索—入库 返回示例

{
    "log_id": 2263663554,
    "cont_sign": "4261577168,501945506"
}

绘本图片搜索—检索

完成入库后,可使用该接口实现绘本图检索。支持传入指定分类维度(具体变量tags)进行检索,返回结果支持翻页(具体变量pn、rn)

请注意,检索接口不返回原图,仅反馈入库时填写的brief信息,请调用入库接口时尽量填写可关联至本地图库的图片id或者图片url等信息

""" 读取图片 """
def get_file_content(filePath):
    with open(filePath, 'rb') as fp:
        return fp.read()

image = get_file_content('example.jpg')

""" 调用绘本图片搜索—检索, 图片参数为本地图片 """
client.pictureBookSearchImage(image)

""" 如果有可选参数 """
options = {}
options["tags"] = "100,11"
options["tag_logic"] = "0"
options["pn"] = "100"
options["rn"] = "250"

""" 带参数调用绘本图片搜索—检索, 图片参数为本地图片 """
client.pictureBookSearchImage(image, options)

url = "http//www.x.com/sample.jpg"

""" 调用绘本图片搜索—检索, 图片参数为远程url图片 """
client.pictureBookSearchUrl(url)

""" 如果有可选参数 """
options = {}
options["tags"] = "100,11"
options["tag_logic"] = "0"
options["pn"] = "100"
options["rn"] = "250"

""" 带参数调用绘本图片搜索—检索, 图片参数为远程url图片 """
client.pictureBookSearchUrl(url, options)

绘本图片搜索—检索 请求参数详情

参数 是否必选 类型 可选值范围 说明
image string - 图像数据,base64编码后进行urlencode,要求base64编码和urlencode后大小不超过4M。(和url二选一,image优先级更高),注意要去掉图片头部,如(data:image/jpg;base64,);最短边至少150px,最长边最大4096px,长宽比在1:10-10:1之间。支持jpg/png/bmp格式
url string - 图片URL,和image二选一,image优先级更高,由于图床的差异性,抓图服务无法适配所有的图床,部分URL可能抓不到图,或者图片下载超时,遇到上述情况时请更换图片URL、或者将图片下载到本地转码后上传
tags string 1 - 65535范围内的整数 分类维度信息,tag间以逗号分隔,最多可传入2个tag,tag间无层级关系,示例:"100,11"
tag_logic string 0,1 检索时tag之间的逻辑, 0:逻辑and,1:逻辑or
pn string 0 - 999范围内的整数 分页功能,起始位置,例:0,代表从第1个结果开始。注:未指定分页时,默认返回前300个结果;接口返回数量最大限制1000个,例如:起始位置为900,截取条数500条,接口也只返回第901 - 1000条的结果,共计100条
rn string 1 - 1000范围内的整数 分页功能,截取条数,例:250

绘本图片搜索—检索 返回数据参数详情

字段 是否必选 类型 说明
log_id uint64 唯一的log id,无实际含义,用于问题定位
result_num uint32 检索结果数
result object[] 结果数组
+cont_sign string 入库图片签名,可以用来删除图片或定位问题
+score float 图片相关性,取值范围0-1,越接近1表示越相关
+brief string 调用入库add接口时添加的brief信息,为保证该结果有效性,请入库时填写可关联至本地图片库的有效id信息
has_more bool 是否还有下一页,返回值:true、false;如果不分页,不用关注该字段

绘本图片搜索—检索 返回示例

{
    "result_num": 1,
    "result": [
        {
            "score": 0.97976700290421,
            "brief": "./data/jay1.jpg",
            "cont_sign": "475124309,1080176642"
        }
    ],
	"has_more": "false",
    "log_id": 1968648150
}

绘本图片搜索—更新

更新图库中图片的摘要和分类信息(具体变量为brief、tags)

""" 读取图片 """
def get_file_content(filePath):
    with open(filePath, 'rb') as fp:
        return fp.read()

image = get_file_content('example.jpg')

""" 调用绘本图片搜索—更新, 图片参数为本地图片 """
client.pictureBookUpdate(image)

""" 如果有可选参数 """
options = {}
options["brief"] = "{\"name\":\"周杰伦\", \"id\":\"666\"}"
options["tags"] = "100,11"

""" 带参数调用绘本图片搜索—更新, 图片参数为本地图片 """
client.pictureBookUpdate(image, options)

url = "http//www.x.com/sample.jpg"

""" 调用绘本图片搜索—更新, 图片参数为远程url图片 """
client.pictureBookUpdateUrl(url)

""" 如果有可选参数 """
options = {}
options["brief"] = "{\"name\":\"周杰伦\", \"id\":\"666\"}"
options["tags"] = "100,11"

""" 带参数调用绘本图片搜索—更新, 图片参数为远程url图片 """
client.pictureBookUpdateUrl(url, options)

contSign = "8cnn32frvrr2cd901"

""" 调用绘本图片搜索—更新, 图片参数为图片签名 """
client.pictureBookUpdateContSign(contSign)

""" 如果有可选参数 """
options = {}
options["brief"] = "{\"name\":\"周杰伦\", \"id\":\"666\"}"
options["tags"] = "100,11"

""" 带参数调用绘本图片搜索—更新, 图片参数为图片签名 """
client.pictureBookUpdateContSign(contSign, options)

绘本图片搜索—更新 请求参数详情

参数 是否必选 类型 可选值范围 说明
image string - 图片数据,base64编码后进行urlencode,要求base64编码和urlencode后大小不超过4M,和url、cont_sign三选一,优先级:image > url > cont_sign,注意要去掉图片头部,如(data:image/jpg;base64,),最短边至少150px,最长边最大4096px,长宽比在1:10-10:1之间。支持jpg/png/bmp格式
url string - 图片URL,和image、cont_sign三选一,优先级:image > url > cont_sign ,由于图床的差异性,抓图服务无法适配所有的图床,部分URL可能抓不到图,或者图片下载超时,遇到上述情况时请更换图片URL、或者将图片下载到本地转码后上传
cont_sign string - 图片签名,和image、url三选一,优先级:image > url > cont_sign;不支持批量传入签名,样例:"932301884,10680062193"
brief string - 更新的摘要信息,最长256B。样例:{"name":"周杰伦", "id":"666"}
tags string 1 - 65535范围内的整数 更新的分类信息,tag间以逗号分隔,最多2个tag。样例:"100,11"

绘本图片搜索—更新 返回数据参数详情

字段 是否必选 类型 说明
log_id uint64 唯一的log id,用于问题定位

绘本图片搜索—更新 返回示例

{
    "log_id": 2263663554
}

绘本图片搜索—删除

删除图库中的图片,支持批量删除,批量删除时请传cont_sign参数,勿传image、url,最多支持100个cont_sign。

图片删除延时生效,每天数据库定时更新进行物理删除,刚删除时仍然可以在图库中检索到(但图库管理后台是同步清除),请过一段时间再验证,一般最多延时4小时左右

""" 读取图片 """
def get_file_content(filePath):
    with open(filePath, 'rb') as fp:
        return fp.read()

image = get_file_content('example.jpg')

""" 调用删除绘本图,传入参数为图片 """
client.pictureBookDeleteByImage(image)

url = "http//www.x.com/sample.jpg"

""" 调用删除绘本图,图片参数为远程url图片 """
client.pictureBookDeleteByUrl(url)

contSign = "8cnn32frvrr2cd901"

""" 调用删除绘本图,传入参数为图片签名 """
client.pictureBookDeleteBySign(contSign)

绘本图片搜索—删除 请求参数详情

参数 是否必选 类型 可选值范围 说明
image string - 图片数据,base64编码后进行urlencode,要求base64编码和urlencode后大小不超过4M,(和url、cont_sign三选一,优先级:image > url > cont_sign),注意要去掉图片头部,如(data:image/jpg;base64,)。最短边至少150px,最长边最大4096px,长宽比在1:10-10:1之间。支持jpg/png/bmp格式
url string - 图片URL,和image、cont_sign三选一,image优先级更高,由于图床的差异性,抓图服务无法适配所有的图床,部分URL可能抓不到图,或者图片下载超时,遇到上述情况时请更换图片URL、或者将图片下载到本地转码后上传
cont_sign string - 图片签名(和image、url三选一),支持批量删除,批量删除时请勿传image、url,最多支持100个cont_sign列表,样例:"932301884,1068006219;316336521,553141152;2491030726,1352091083"

绘本图片搜索—删除 返回数据参数详情

字段 是否必选 类型 说明
log_id uint64 唯一的log id,用于问题定位

绘本图片搜索—删除 返回示例

{
  "log_id": 50488417
}

面料图片搜索—入库

SDK 调用示例

""" 读取图片 """
def get_file_content(filePath):
    with open(filePath, 'rb') as fp:
        return fp.read()

image = get_file_content('example.jpg')
brief = "{\"name\":\"周杰伦\", \"id\":\"666\"}"

""" 调用面料图片搜索—入库, 图片参数为本地图片 """
client.materielAdd(image, brief)

""" 如果有可选参数 """
options = {}
options["tags"] = "100,11"

""" 带参数调用面料图片搜索—入库, 图片参数为本地图片 """
client.materielAdd(image, brief, options)

url = "http//www.x.com/sample.jpg"

brief = "{\"name\":\"周杰伦\", \"id\":\"666\"}"

""" 调用面料图片搜索—入库, 图片参数为远程url图片 """
client.materielAddUrl(url, brief)

""" 如果有可选参数 """
options = {}
options["tags"] = "100,11"

""" 带参数调用面料图片搜索—入库, 图片参数为远程url图片 """
client.materielAddUrl(url, brief, options)

接口详情

可参考API文档:面料图片搜索—入库

面料图片搜索—检索

SDK 调用示例

""" 读取图片 """
def get_file_content(filePath):
    with open(filePath, 'rb') as fp:
        return fp.read()

image = get_file_content('example.jpg')

""" 调用面料图片搜索—检索, 图片参数为本地图片 """
client.materielSearch(image)

""" 如果有可选参数 """
options = {}
options["tags"] = "100,11"
options["tag_logic"] = "0"
options["pn"] = "100"
options["rn"] = "250"

""" 带参数调用面料图片搜索—检索, 图片参数为本地图片 """
client.materielSearch(image, options)

url = "http//www.x.com/sample.jpg"

""" 调用面料图片搜索—检索, 图片参数为远程url图片 """
client.materielSearchUrl(url)

""" 如果有可选参数 """
options = {}
options["tags"] = "100,11"
options["tag_logic"] = "0"
options["pn"] = "100"
options["rn"] = "250"

""" 带参数调用面料图片搜索—检索, 图片参数为远程url图片 """
client.materielSearchUrl(url, options)

接口详情

可参考API文档:面料图片搜索—检索

面料图片搜索—更新

SDK 调用示例

""" 读取图片 """
def get_file_content(filePath):
    with open(filePath, 'rb') as fp:
        return fp.read()

image = get_file_content('example.jpg')
brief = "{\"name\":\"周杰伦\", \"id\":\"666\"}"

""" 调用面料图片搜索—更新, 图片参数为本地图片 """
client.materielUpdate(image, brief)

""" 如果有可选参数 """
options = {}
options["tags"] = "100,11"

""" 带参数调用面料图片搜索—更新, 图片参数为本地图片 """
client.materielUpdate(image, brief, options)

url = "http//www.x.com/sample.jpg"

""" 调用面料图片搜索—更新, 图片参数为远程url图片 """
client.materielUpdateUrl(url ,brief)

""" 如果有可选参数 """
options = {}
options["tags"] = "100,11"

""" 带参数调用面料图片搜索—更新, 图片参数为远程url图片 """
client.materielUpdateUrl(url, brief, options)

contSign = "8cnn32frvrr2cd901"

""" 调用面料图片搜索—更新, 图片参数为图片签名 """
client.materielUpdateContSign(contSign, brief)

""" 如果有可选参数 """
options = {}
options["tags"] = "100,11"

""" 带参数调用面料图片搜索—更新, 图片参数为图片签名 """
client.materielUpdateContSign(contSign, brief, options)

接口详情

可参考API文档:面料图片搜索—更新

面料图片搜索—删除

SDK 调用示例

""" 读取图片 """
def get_file_content(filePath):
    with open(filePath, 'rb') as fp:
        return fp.read()

image = get_file_content('example.jpg')

""" 调用删除面料图片,传入参数为图片 """
client.materielDeleteByImage(image)

url = "http//www.x.com/sample.jpg"

""" 调用删除面料图片,图片参数为远程url图片 """
client.materielDeleteByUrl(url)

contSign = "8cnn32frvrr2cd901"

""" 调用删除面料图片,传入参数为图片签名 """
client.materielDeleteBySign(contSign)

接口详情

可参考API文档:面料图片搜索—删除

上一篇
快速入门
下一篇
常见问题
十一月份什么星座 糖尿病人早餐吃什么好 阳痿挂什么科 骨骼是什么意思 阿托伐他汀钙片治什么病
花圃是什么意思 淋巴结清扫是什么意思 1月1日是什么节 觉得什么 失眠是什么
厄运是什么意思 胃黏膜病变是什么意思 夏天床上铺什么凉快 流连忘返的返是什么意思 array是什么意思
身陷囹圄是什么意思 皮肤瘙痒吃什么药 no2是什么 清洁度2度是什么意思 口臭吃什么药效果最好
推手是什么意思hcv7jop7ns3r.cn 什么治咳嗽最快最有效huizhijixie.com 蚊子怕什么植物hcv9jop6ns9r.cn 常吃南瓜有什么好处和坏处hcv8jop5ns9r.cn 吃完榴莲后不能吃什么hcv8jop9ns1r.cn
逆商是什么hcv8jop5ns9r.cn c14检查前需要注意什么gangsutong.com 莆田医院是什么意思hkuteam.com 双肾结晶是什么意思hcv8jop7ns6r.cn 香港五行属什么hcv8jop9ns4r.cn
时辰宜忌是什么意思hcv9jop3ns4r.cn 疗养是什么意思hcv8jop8ns9r.cn 火车硬卧代硬座是什么意思hcv9jop3ns0r.cn 爷爷和孙子是什么关系bysq.com 九门提督相当于现在什么官zhongyiyatai.com
子宫为什么长肌瘤96micro.com 湾仔码头水饺为什么贵hcv8jop2ns8r.cn c3是什么车型hcv8jop4ns0r.cn 诸葛亮属相是什么生肖hcv8jop9ns5r.cn 乳头痒是怎么回事是什么原因hcv9jop2ns4r.cn
百度