天行机器人可用于接入开发网站/应用程序/App/微信/百度/支付宝小程序等，机器人支持自定义身份属性设置，自定义私有词库和无应答时随机回复。在天行数据后台设置机器人身份属性后，可以通过向机器人发送指令“robot”快速查看设置效果。天行机器人的指令优先级为：私有词库-公共词库-文本库-新闻库-图文库-自定义的随机回复-系统随机回复。
天行机器人是一个全能的AI机器人，她可以说（将结果进行语音合成后返回）、可以听（将输入的语音进行识别后返回）、可以看（将输入的图片进行识别后返回），机器人所有的返回结果是处理后的数据，实现正常的人机交互沟通、而不是简单转换你输入的内容。
请求方法
HTTP/HTTPS POST
接口地址
http://api.tianapi.com/txapi/robot/
身份属性
自定义机器人身份属性，你可以在天行数据后台机器人自定义回复和词库中添加以下代码，系统自动替换为对应的设置。当然，你也可以留空，属性代码会原样返回，然后在你的程序中执行对应的替换。
| 属性 | 代码 | 属性 | 代码 |
|---|---|---|---|
| 机器人名称 | {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 //伤心
}
}
]}测试资源
在线体验： https://www.tianapi.com/demo/robot/
立即测试：https://www.tianapi.com/gethttp/47
鄂公网安备 42112302000017号