人脸识别API接口 - 天行数据TianAPI

人脸识别服务接口

148
323

人脸识别

人脸识别服务接口免费接口正常调用

增值服务：增加可用次数，1元500次
永久额度：1500次，注册后一次赠送的额度
每天赠送：高级会员500次，黄金会员2500次

在线测试申请接口

▼ 接口文档
价格
错误码
参考代码
生成小程序

▼ 接入信息

接口地址：http://api.tianapi.com/txapi/face/index
请求示例：http://api.tianapi.com/txapi/face/index?key=APIKEY&image=https://www.tianapi.com/weixin/debug/images/photo.jpg
支持协议：HTTP/HTTPS
请求方式：GET/POST
返回格式：UTF8 JSON

▼ 请求参数

请求参数	类型	必填	参数位置	示例值	备注说明
key	string	是	urlParam	用户自己的APIKEY	api密钥
image	string	是	urlParam	https://www.tianapi.com/weixin/debug/images/photo.jpg	图片URL

▼ 返回示例

▼ 返回参数

返回参数	类型	示例值	备注说明
location	array		人脸在图片中的位置
face_probability	int	1	人脸置信度，代表这是一张人脸的概率，0最小、1最大
angle	array		人脸旋转角度参数
age	int	22	年龄
beauty	float	72.72	颜值打分，范围0-100，越大表示越美
expression	array		表情及可信度，0最小、1最大
face_shape	array		脸型及可信度，0最小、1最大
gender	array		性别及可信度，0最小、1最大
glasses	array		是否带眼镜及可信度，0最小、1最大
race	array		人种及可信度，0最小、1最大
eye_status	array		双眼状态（睁开/闭合）及可能性，越接近0闭合的可能性越大
emotion	array		情绪及可信度，0最小、1最大
face_type	array		真实人脸/卡通人脸

▼ 接口价格

用户等级	永久赠送额度	每日赠送额度	综合免费调用次数	备注说明
普通用户	30000天行币	0	永久1500次	新用户注册即可获得永久赠送额度在线充值
高级会员	30000天行币	10000天行币	永久1500次+每日500次	开通会员即享永久赠送额度+每日赠送额度
黄金会员	30000天行币	50000天行币	永久1500次+每日2500次	开通会员即享永久赠送额度+每日赠送额度
提示：普通用户可以调用免费接口并消耗永久额度。会员用户优先使用每日赠送额度。如需要更高额度或不限次调用，请联系我们调整等级和给予最大优惠。

▼ 错误状态码

错误代码	错误消息	解释帮助
100	内部服务器错误	出现此错误码请及时反馈或等待修复
110	接口暂时维护中	接口暂时关闭维护中，请注意相关公告
120	IP请求来源受限	设置了IP白名单
130	API调用频率超限	API超出了分钟频率限制
140	API没有调用权限	该API只有会员或特定用户才可以调用
150	天行币余额不足	账号天行币余额不足，请在个人中心查看
160	账号未申请该接口	请先在对应的接口详情页面申请接口
230	key错误或为空	请检查apikey是否填写错误或未正确传递
240	缺少key参数	请检查是否传递了key参数，如变量请检查是否赋值
250	数据查询失败	数据查询或转换失败
260	关键词不得为空	word参数不要传递null或空值
270	缺少有效数据	部分接口需要传递数据，请按接口说明来
280	缺少必要的参数	缺少必填的参数，请根据接口文档检查
290	超过资源字节限制	超过了最大输入字节限制
1开头的是系统级错误，2开头的是用户级错误，其中200代码表示数据请求成功。

▼ 参考代码

其他可直接使用的部分开源项目推荐。另外此处的参考代码都是get方式请求，post请求请参考此项目。

留言反馈返回顶部