天行数据API智能机器人接口
机器人对话接口请求方法HTTP/HTTPSPOST
接口地址http://api.tianapi.com/txapi/robot/
使用帮助机器人支持自定义身份属性设置，自定义私有词库和无应答时随机回复。在天行数据后台设置机器人身份属性后，可以通过向机器人发送指令“robot”快速查看设置效果。天行机器人的指令优先级为：私有词库-公共词库-文本库-新闻库-图文库-自定义的随机回复-系统随机回复。天行机器人是一个全能的AI机器人，她可以说（将结果进行语音合成后返回）、可以听（将输入的语音进行识别后返回）、可以看（将输入的图片进行识别后返回），机器人所有的返回结果是处理后的数据，实现正常的人机交互沟通、而不是简单转换你输入的内容。
身份属性自定义机器人身份属性，你可以在天行数据后台机器人自定义回复和词库中添加以下代码，系统自动替换为对应的设置。当然，你也可以留空，属性代码会原样返回，然后在你的程序中执行对应的替换。
属性代码属性代码机器人名称{robotname}机器人爱好{robothobby}机器人称呼{appellation}机器人工作{robotwork}机器人年龄{robotage}机器人家乡{hometown}机器人性别{robotsex}机器人父亲{robotfather}机器人星座{constellation}机器人母亲{robotmother}你可以下拉到底部查看示例
参数表请求参数类型必填参数位置描述备注说明keystring是urlParamAPI密钥（请在个人中心获取）用户自己的keyquestionstring是urlParam问题，对话内容如：robotuseridstring是urlParam用户ID，机器人上下文关联必须为数字或字母modeint否urlParam模式，宽松0、严格1、私有2宽松模式[默认]识别率高，严格模式精准性高restypeint否urlParam输入内容类型文本0[默认]、语音1、人脸2、其他3datatypeint否urlParam返回数据类型文本0[默认]、语音1vocint否urlParam语性中年男0、中年女1(默认)、萝莉音2、正太音3speedint否urlParam语速语速，取值0-9，默认为5中语速volumeint否urlParam音量音量，取值0-9，默认为5中音量userid的值必须为数字或字母，且应该是每个用户唯一的。这样系统才能判断是否为同一用户。当mode参数值为1时严格模式，机器人回答成功率下降，但问题相关性大大提高。mode参数值为2时则为私有模式，机器人只会从私有词库中寻找结果，未找到结果的情况下，也只会返回随机应答中用户设置的内容。当restype参数值为1-3时，question的内容必须为图片或语资源链接。语音识别支持pcm[建议]、wav、amr三种格式，请注意：语音合成和语音识别都是指机器人处理后的内容，而不是你输入的内容。
返回示例1，文本类型通过指令“robot”来快速预览你的机器人身份属性设置：亲爱的{appellation}你好，我叫{robotname}，性别{robotsex}，来自{hometown}，正在从事{robotwork}工作。{constellation}的我，爱好{robothobby}也喜欢和人类做朋友！
{“code”:200,“msg”:“success”,“datatype”:“text”,//返回的数据类型：text文本；view图文；image图片；voice语音“newslist”:[{“reply”:“亲爱的主银你好，我叫小天，性别男，来自湖北，正在从事互联网工作。金牛座的我，爱好摄影也喜欢和人类做朋友！”}]}
请注意在调用数据时一定要先判断datatype类型，后期可能是不同数据结构的标识码。2，语音类型让机器人开口说话，只需设置datatype参数的值为1。暂只支持机器人介绍，语音合成技术由百度及科大讯飞提供（试听下载）
{“code”:200,“msg”:“success”,“datatype”:“voice”,//datatype=>0（text文本[默认]）；datatype=>1（voice语音）“newslist”:[{“voice_reply”:“/voice/self-introduction.mp3”//资源域名http://res.tianapi.com/}]}
请注意20190202后指定机器人语音回复时，直接返回合成音频数据流。3，语音识别类型语音识别返回结果与普通文本结构完全一致，你可以下载这段音频测试。（识别下载）
{“code”:200,“msg”:“success”,“datatype”:“text”,“newslist”:[{“reply”:“语音识别后机器人回答的内容”//资源地址voice/self-introduction.wav}]}友情提示：语音输入支持pcm[建议]、wav、amr三种格式，请保证正确的文件后缀。采样率16000，仅支持单声道音频文件。4，图文类型当机器人在新闻和图文库中检索到内容时会返回一个最大为10的图文列表。该类型不支持用户主动要求，由系统经判断输出。
{“code”:200,“msg”:“success”,“datatype”:“view”,//view图文类型“newslist”:[{“ctime”:“2019-01-2109:56”,“title”:“我们为何要睡觉？记忆能被篡改吗？一文看透腾讯科学小会精华内容”,“description”:“腾讯科技”,“picUrl”:“http://inews.gtimg.com/newsapp_ls/0/7376663729_300240/0”,“url”:“http://tech.qq.com/a/20190121/003781.htm”},{“ctime”:“2019-01-1511:48”,“title”:“我们用上了王欣的匿名熟人社交产品这是它所有”,“description”:“移动互联”,“picUrl”:“http://imgsize.ph.126.net/?imgurl=http://cms-bucket.ws.126.net/2019/01/15/452c878b6db14ea7afdb4e1667ea59d4.png_200x140x1x85.jpg”,“url”:“http://tech.163.com/19/0115/11/E5IED2C000097U7R.html”},{“ctime”:“2019-01-1200:00”,“title”:“我们出线了！国足提前一轮晋级淘汰赛”,“description”:“凤凰足球”,“picUrl”:“http://d.ifengimg.com/w145_h103/e0.ifengimg.com/02/2019/0111/DC3C33224A789A7095EE7AD5347CA9DC4A3D4059_size142_w950_h633.jpeg”,“url”:“http://sports.ifeng.com/a/20190111/60233128_0.shtml”}]}5，图片识别类型目前仅支持人脸识别，返回人脸识别结果年龄、性别、人种、微笑度、颜值等。
{“code”:200,“msg”:“success”,“datatype”:“face”,//人脸识别类型“newslist”:[{“age”:28,//年龄“gender”:“Female”,//性别“ethnicity”:“ASIAN”,//人种“smile”:100,//微笑程度“beauty”:{//取样颜值“male”:81.588,//男性认为的颜值“female”:83.842//女性认为的颜值},“emotion”:{//人物情绪“anger”:0.011,//愤怒“happiness”:98.983,//开心“sadness”:0.29//伤心}}]}6，测试资源
语音回复：http://res.tianapi.com/voice/self-introduction.mp3语音识别：http://res.tianapi.com/voice/self-introduction.wav接口介绍：https://www.tianapi.com/apiview/47在线体验：https://www.tianapi.com/demo/robot/立即测试：https://www.tianapi.com/gethttp/47