天行机器人API接口 - 天行数据TianAPI

47
3686

天行机器人

一个有趣的AI机器人免费接口正常调用

该接口普通会员申请即送10000次永久测试额度
高级会员每天10000次黄金会员每天50000次

在线测试申请接口

机器人支持自定义身份属性设置，自定义私有词库和无应答时随机回复。在天行数据后台设置机器人身份属性后，可以通过向机器人发送指令“robot”快速查看设置效果。
天行机器人的指令优先级为：私有词库-公共词库-文本库-新闻库-图文库-自定义的随机回复-系统随机回复。

天行机器人是一个全能的AI机器人，她可以说（将结果进行语音合成后返回）、可以听（将输入的语音进行识别后返回）、可以看（将输入的图片进行识别后返回），机器人所有的返回结果是处理后的数据，实现正常的人机交互沟通、而不是简单转换你输入的内容。调用此接口，请阅读接口文档或查看功能介绍天行机器人2.0上线了。

另外请注意：普通方式1天行币/次，机器人说话、语音识别、图像识别（含人脸）100天行币/次。

建议对question参数值进行urlencode编码后在传递，否则部分字符无法识别，例如会导致四则运算失效等。

▼ 接口信息

接口地址：http://api.tianapi.com/txapi/robot/index
请求示例：http://api.tianapi.com/txapi/robot/index?key=APIKEY&question=robot
支持协议：HTTP/HTTPS
请求方式：GET/POST
返回格式：UTF8 JSON

▼ 请求参数

请求参数	类型	必填	参数位置	示例值	备注说明
key	string	是	urlParam	用户自己的APIKEY	API密钥
question	string	是	urlParam	robot	提问
userid	string	否	urlParam	5698336999533656	机器人上下文关联，必须唯一
limit	int	否	urlParam	10	机器人分析系数，取值1-10
mode	int	否	urlParam	0	工作模式，宽松0[默认]、精确1，私有2
restype	int	否	urlParam	0	输入类型，文本0[默认]、语音1、人脸2、其他3
datatype	int	否	urlParam	0	返回类型，文本0[默认]、语音1
num	int	否	urlParam	10	图文返回数量，取值1-10
voc	int	否	urlParam	0	语性，中年男0、中年女1、萝莉音2、正太音3
speed	int	否	urlParam	5	语速，取值0-9，默认为5中语速
volume	int	否	urlParam	5	音量，取值0-9，默认为5中音量

▼ 返回示例

▼ 返回参数

返回参数	类型	示例值	备注说明
reply	string	亲爱的主银你好，我叫小天......	回答内容

▼ 接口价格

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

▼ 错误状态码

错误代码	错误消息	解释帮助
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代码表示数据请求成功。