首页 > 分享 > 宠物图像识别API接口

宠物图像识别API接口

萌宠菠菠乐园
2024-10-15 12:31

▼ 请求参数

post方式请求时，enctype应为application/x-www-form-urlencoded

上传文件二进制数据流方式，enctype必须为multipart/form-data

参数url、base64中有特殊字符时，建议对值urlencode编码后传递

名称类型必须示例值/默认值说明 keystring是您自己的APIKEY（注册账号后获得）API密钥imgstring是base64图片base64编码（与imgurl参数二选一）imgurlstring否https://www.tianapi.com/static/img/ocr/cat.jpg图片URL地址（支持jpg/png/bmp格式）

▼ 返回示例

接口数据样例仅作为预览参考，请以实际测试结果为准

旧域名返回的json结构和现在略有不同，请点击此处查看说明

成功调用，code=>200并产生计费：

{ "code": 200, "msg": "success", "result": { "list": [ { "trust": 41, "pettype": 1, "name": "阿拉斯加雪橇犬", "engName": "AlaskanMalamute", "characters": "非常聪明友好、喜欢吠叫", "nation": "美国", "easyOfDisease": "肠胃疾病", "life": "12年~15年", "price": "3000起", "desc": "　　阿拉斯加雪橇犬（AlaskanMalamute），又称阿拉斯加马拉穆，是最古老的雪橇犬之一，原产于美国，AKC分类属工作犬组。因它的四肢发达，体格健壮，培育它的目的是为了耐力而不是速度，因而它们的主要用途是拉雪橇。作为宠物，阿拉斯加雪橇犬一旦成熟后有着非常安静、高雅的气质，而且它们忠于主人。", "feature": "　　阿拉斯加体型较大，毛发蓬松，外型俊朗优美，有狼一样冷峻的外表，但是内心却非常友善，常被人们跟哈士奇混幺，他的体型比哈士奇大点，毛发也比哈士奇长。", "characterFeature": "　　随着社会的不断发展，阿拉斯加雪橇犬受到很多年轻人的喜爱，阿拉斯加早年是当做工作犬来使用的，现已进入很多家庭，之后会渐渐的习惯家庭饲养，服从家里其他人的指挥命令。", "careKnowledge": "　　随着社会的发展，养宠也成了一种时尚。因阿拉斯加具有很强的语言能力，以及英俊的外表，又能够领会人的语言、表情和各类手势，因此饲养的人越来越多。由于阿拉斯加的肠胃天生就不好，因此在生活上及饮食上主人应需要多加留意。", "feedPoints": "", "url": "http://www.boqii.com/entry/detail/609.html", "coverURL": "http://img.boqiicdn.com/Data/BK/P/img50961416195246.jpg" }, { "trust": 1, "pettype": 1, "name": "哈士奇", "engName": "SiberianHuskiy", "characters": "聪明机灵、极度热情、神经质", "nation": "俄罗斯", "easyOfDisease": "肠胃疾病", "life": "9-15年", "price": "2000-4000元", "desc": "　　西伯利亚", "feature": "　　西伯利亚雪橇犬是一种原始的古老犬种，因它的独特嘶哑的叫声被称之为当今的哈士奇。很早前哈士奇是最原始的交通工具专门拉雪橇的，并用这种狗猎取和饲养驯鹿，或者繁殖这种狗，然后带出他们居住的冻土地，换取温饱。典型狼性犬。", "characterFeature": "　　哈士奇的外表英俊潇洒，精致的五官和丰富的肢体语言充满了奇特的表现，无需复杂的交谈，就能轻易了解他的喜怒哀乐。哈士奇时常会有点神经质。", "careKnowledge": "　　哈士奇虽然看着一副冷漠无情的样子，事实上，哈士奇对人很友好、温柔、热情的。喜欢与人交往是哈士奇的典型性格。通常不表现出护卫犬强烈的领地占有欲，不对陌生人过多的怀疑，也不会攻击其他犬类。因此有很多人喜欢哈士奇。他对主人非常忠诚，一条忠诚的小狗有一个健康的身体是非常重要的。", "feedPoints": "哈士奇有着敏感的肠胃，因此在饮食上需要主人多加重视", "url": "http://www.boqii.com/entry/detail/357.html", "coverURL": "http://img.boqiicdn.com/Data/BK/P/imagick14371435571930.png" } ] } }

错误调用，查看接口错误码释义：

{ "code": 150, "msg": "API可用次数不足" }

▼ 返回参数

公共参数指所有接口都会返回的参数，应用参数每个接口都不同

名称类型示例值说明公共参数codeint200状态码msgstringsuccess错误信息resultobject{}返回结果集应用参数 trustint41可信度，越接近100表示越可信pettypeint1宠物类型，0猫科、1犬类、2爬行类、3小宠物类、4水族类namestring哈士奇宠物名字engNamestringSiberianHuskiy宠物英文名charactersstring聪明机灵、极度热情、神经质性格特点nationstring俄罗斯祖籍easyOfDiseasestring肠胃疾病易患病lifestring9-15年寿命pricestring2000-4000元价格descstring西伯利亚描述featurestring西伯利亚雪橇犬是一种原始的古老犬种......体态特征characterFeaturestring哈士奇的外表英俊潇洒......特点careKnowledgestring哈士奇虽然看着一副冷漠无情的样子......照顾须知feedPointsstring哈士奇有着敏感的肠胃......喂养注意urlstringhttp://www.boqii.com/entry/detail/357.html详细来源coverURLstringhttp://img.boqiicdn.com/Data/BK/P/imagick14371435571930.png封面图片

▼ 接口价格

充值金额可用次数参考单价免费20次≈0元/次10元(10W天豆)1000次≈0.01元/次100元(110W天豆)11000次≈0.0091元/次500元(600W天豆)60000次≈0.0083元/次2000元(2600W天豆)260000次≈0.0077元/次本接口为按次计费类接口，如接口可用次数不足可点此充值天豆获得更多可用次数（优惠）

▼ 返回状态码

错误信息可能会有所调整，请根据错误状态码(code)进行流程判断

错误状态码错误信息解释帮助100内部服务器错误报此错误码请及时反馈或等待官方修复110当前API已下线接口已下线无法使用，可关注相关通知120API暂时维护中接口暂时关闭维护中，请注意相关公告130API调用频率超限超过每秒请求数上限，可在控制台-接口管理中查询140API没有调用权限请检查是否自行在接口管理中停用或被禁用了该接口150API可用次数不足免费类接口套餐超限或计次类接口余额不足，点此查看说明160账号未申请该API请先在接口文档页面申请该接口，点此查看说明170Referer请求来源受限设置了Referer白名单，但来源Referer不在白名单内180IP请求来源受限设置了IP白名单，但来源IP不在白名单内190当前key不可用通常为账号无效，此状态无法恢复230key错误或为空请检查apikey是否填写错误，点此查看帮助240缺少key参数请检查是否传递了key参数或者编码格式是否符合要求250数据返回为空数据查询或转换失败，请检查输入值或注意中文编码问题260参数值不得为空请检查关键参数是否传递了空值270参数值不符合要求参数值不符合基本格式要求，点此查看说明280缺少必要的参数缺少必填的参数，请根据接口文档检查290超过最大输入限制参数值超过输入范围，请查看接口文档的说明错误码1开头的是系统级错误，2开头的是用户级错误，其中200表示请求成功处理并计费。

▼ 参考代码

此处代码仅演示关键请求片段，实际使用请根据具体环境修改

如需深入学习参考，可点击此处查看部分第三方完整开源项目