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

47
13240

天行机器人

一个有趣的AI机器人会员免费正常调用

该接口首次申请即送50000+免费调用额度
高级会员每天10000次黄金会员无限次

机器人支持自定义身份属性、私有词库、无应答时随机回复及开启或关闭机器人三十多项能力。在天行数据后台设置机器人身份属性后，可以通过向机器人发送指令“robot”快速查看设置效果。请登录控制台设置机器人身份信息，否则部分变量会直接返回代码。

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

建议对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

▼ 请求参数

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

请求参数中有url或特殊字符时，应该对值urlencode编码下

名称	类型	必填	位置	示例值	说明
key	string	是	urlParam	用户自己的APIKEY	API密钥
question	string	是	urlParam	robot	提问
userid	string	否	urlParam	5698336999533656	机器人上下文关联，必须唯一
limit	int	否	urlParam	5	分析系数，取值1-10，1速度性能最高、10回答率最高，默认为5两者兼顾
mode	int	否	urlParam	0	工作模式，宽松模式0[默认]、精确模式1，私有词库模式2
priv	int	否	urlParam	0	私有词库匹配模式，完整匹配0[默认]、智能匹配1，模糊匹配2，结尾匹配3，开头匹配4
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中音量

▼ 返回示例

返回示例作为参考，建议以实际测试结果为准

▼ 返回参数

名称	类型	示例值	说明
datatype	string	text	返回的数据类型：text文本；view图文；image图片；voice语音
reply	string	亲爱的主银你好，我叫小天......	回答内容

▼ 接口价格

用户等级	会员接口数	每日赠送次数	会员价格	说明
普通会员	15个	0次	免费	免费额度外的调用1天行币/次
高级会员	30个	10000次	99元/年	每个会员接口每天赠送1W次
黄金会员	不限	不限	299元/年(限时特价)	每个会员接口每天都是无限次
提示：首次申请本接口可获赠50000次调用额度，如项目有更高需求请点此升级会员等级。

▼ 错误状态码

错误消息可能会有所调整，请根据错误代码进行流程判断

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