天行数据API智能机器人接口

机器人对话接口
请求方法
HTTP/HTTPS POST

接口地址
http://api.tianapi.com/txapi/robot/

使用帮助
机器人支持自定义身份属性设置，自定义私有词库和无应答时随机回复。在天行数据后台设置机器人身份属性后，可以通过向机器人发送指令“robot”快速查看设置效果。天行机器人的指令优先级为：私有词库-公共词库-文本库-新闻库-图文库-自定义的随机回复-系统随机回复。
天行机器人是一个全能的AI机器人，她可以说（将结果进行语音合成后返回）、可以听（将输入的语音进行识别后返回）、可以看（将输入的图片进行识别后返回），机器人所有的返回结果是处理后的数据，实现正常的人机交互沟通、而不是简单转换你输入的内容。

身份属性
自定义机器人身份属性，你可以在天行数据后台机器人自定义回复和词库中添加以下代码，系统自动替换为对应的设置。当然，你也可以留空，属性代码会原样返回，然后在你的程序中执行对应的替换。

属性 代码 属性 代码
机器人名称 {robotname} 机器人爱好 {robothobby}
机器人称呼 {appellation} 机器人工作 {robotwork}
机器人年龄 { robotage} 机器人家乡 {hometown}
机器人性别 {robotsex} 机器人父亲 {robotfather}
机器人星座 {constellation} 机器人母亲 {robotmother}
你可以下拉到底部查看示例

参数表
请求参数 类型 必填 参数位置 描述 备注说明
key string 是 urlParam API密钥（请在个人中心获取） 用户自己的key
question string 是 urlParam 问题，对话内容 如：robot
userid string 是 urlParam 用户ID，机器人上下文关联 必须为数字或字母
mode int 否 urlParam 模式，宽松0、严格1、私有2 宽松模式[默认]识别率高，严格模式精准性高
restype int 否 urlParam 输入内容类型 文本0[默认]、语音1、人脸2、其他3
datatype int 否 urlParam 返回数据类型 文本0[默认]、语音1
voc int 否 urlParam 语性 中年男0、中年女1(默认)、萝莉音2、正太音3
speed int 否 urlParam 语速 语速，取值0-9，默认为5中语速
volume int 否 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-21 09: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-15 11: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-12 00: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