### **请求方法** HTTP/HTTPS GET ### **接口地址** 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,必须为数字或字母| | limit | int | 否 | urlParam | 机器人分析系数 | 取值1-10,默认最大系数10 | | mode| int | 否 | urlParam | 工作模式 | 宽松0[默认]、精确1,私有2| | restype | int| 否|urlParam | 输入内容类型| 文本0[默认]、语音1、人脸2、其他3 | datatype| int| 否 | urlParam | 返回数据类型|文本0[默认]、语音1 | | num | int| 否 | urlParam | 数量 |默认10,取值1-10 | | 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。暂只支持机器人介绍,语音合成技术由百度及科大讯飞提供([试听下载](http://res.tianapi.com/voice/self-introduction.mp3)) ~~~ { "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,语音识别类型** 语音识别返回结果与普通文本结构完全一致,你可以下载这段音频测试。([识别下载](http://res.tianapi.com/voice/self-introduction.wav)) ~~~ { "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://user.tianapi.com/demo/robot/ 立即测试:https://user.tianapi.com/gethttp/?type=txapi/robot ~~~