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

时间:2019-02-12 21:36:04

天行机器人可用于接入开发网站/应用程序/App/微信/百度/支付宝小程序等,机器人支持自定义身份属性设置,自定义私有词库和无应答时随机回复。在天行数据后台设置机器人身份属性后,可以通过向机器人发送指令“robot”快速查看设置效果。天行机器人的指令优先级为:私有词库-公共词库-文本库-新闻库-图文库-自定义的随机回复-系统随机回复。
天行机器人是一个全能的AI机器人,她可以说(将结果进行语音合成后返回)、可以听(将输入的语音进行识别后返回)、可以看(将输入的图片进行识别后返回),机器人所有的返回结果是处理后的数据,实现正常的人机交互沟通、而不是简单转换你输入的内容。


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

请求方法

HTTP/HTTPS POST

接口地址

http://api.tianapi.com/txapi/robot/

身份属性

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


属性代码属性代码
机器人名称{robotname}机器人爱好{robothobby}
机器人称呼{appellation}机器人工作{robotwork}
机器人年龄{ robotage}机器人家乡{hometown}
机器人性别{robotsex}机器人父亲{robotfather}
机器人星座{constellation}机器人母亲{robotmother}

参数表

请求参数类型必填参数位置描述备注说明
keystringurlParamAPI密钥(请在个人中心获取)用户自己的key
questionstringurlParam问题,对话内容如:robot
useridstringurlParam用户ID,机器人上下文关联必须为数字或字母
modeinturlParam模式,宽松0、严格1、私有2宽松模式[默认]识别率高,严格模式精准性高
restypeinturlParam输入内容类型文本0[默认]、语音1、人脸2、其他3
datatypeinturlParam返回数据类型文本0[默认]、语音1
vocinturlParam语性中年男0、中年女1(默认)、萝莉音2、正太音3
speedinturlParam语速语速,取值0-9,默认为5中语速
volumeinturlParam音量音量 ,取值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


本站所有文章均为天行博客原创,转载请注明来源及出处!

作者:宇天行 (关于我

本文首发地址:https://www.huceo.com/post/485.html

或许您还会喜欢这些文章:

Tags: 作者:宇天行 | 分类:开发技术 | 评论:1 | 浏览:6628