AI-WIFI 接入

接口详细说明

接口地址

http://smartdevice.ai.turingapi.com/speech/chat

请求方法

Method: POST
Content-Type: multipart/form-data

请求参数

参数	必选	类型	说明
parameters	true	json	配置信息
speech	false	opus/speex/amr等格式音频数据	音频文件二进制数据： type=5,文本输入的时候此字段不传

parameters 字段说明

参数	必选	类型	说明
ak	true	String	apiKey,用于权限验证
uid	true	String	设备id加密后的字符串（长度为32位）,详见设备id加密说明
token	true	String	请求令牌,首次请求可以为空,详见token说明
asr	true	int	针对上传音频字段设置控制: 当asr=2(不推荐)时：amr_8K_16bit; 当asr=3时：amr_16K_16bit；当asr=4(推荐)时：opus；当asr=5(不推荐)时：speex（需要用特定的编码工具）; 如果需要其他格式，请联系商务
tts	true	int	语义解析输出结果音频格式控制: 当tts=2时：mp3_24; 当tts=3时：mp3_16(推荐); 当tts=4时：amr_nb; 如果需要其他格式，请联系商务
tone	true	int	tts音色选择: 取值范围20~22;
flag	false	int	结果输出控制标识: 当flag=0时：不输出文本（默认）；当flag=1时：输出asr文本信息；当flag=2时：输出tts文本信息；当flag=3时：输出asr&tts文本信息；
realTime	false	int	流式识别控制字段当realTime=0时：非流式识别（默认），上传音频大小不能超过360KB；当realTime=1时：流式识别，分段的每包音频的大小不能超过20KB，录音时长不超过4秒;
index	false	int	当realTime=1为流式识别时，此字段必选，用以标识音频片段索引。 index从1开始计数，且最后一个音频片段索引必须为负数，如index=1、2、3、-4。注意index最大不能超过30
identify	false	String	当realTime=1时，该字段有效，用于标识一个流式识别过程，所以每个流式识别过程该identify值必须保证唯一性。(要求32位随机数，可由数字和小写字母组成，不支持大写字母和特殊字符)
encode	false	int	上传音频编码方式，主要用于自定义编码支持，非自定义编码可忽略该字段: 当encode=0时：通用编码，即asr字段支持的编码方式（默认）; 当encode=1时：自定编码，若使用该编码方式，则需要提供转码工具，且转码目标格式必须是asr字段支持的格式。
type	false	int	请求类型标识: type=0时：智能聊天（默认）; type=1时：主动交互; type=2时：开机提示语; type=3时：口语评测（需要商务沟通）; type=4时：绘本模式（需要商务沟通）; type=5时：文本输入
speed	false	int	tts语速设置: 取值范围1~9，默认5
pitch	false	int	tts语调设置: 取值范围1~9，默认5
volume	false	int	tts的音量: 取值范围1~9, 默认5
seceneCodes	false	array(数组)	指定使用相应的功能进行文本解析: 例如[20015]为指定中英互译
asr_lan	false	int	选择ASR语言: 0为中文（默认）; 1为英文
tts_lan	false	int	选择TTS语言: 0为中文（默认）; 1为英文
textStr	false	string	当type=5时，用来表示需要输入的文本
contextCode	false	int	需要进入上下文的code，对应功能码: 比如需要使用【下一集】进入视频播放，那么contextCode=20032.
extra	false	json	扩展字段；一些特殊技能中会用到

speech 字段说明

speech为音频文件，当为主动交互请求（type=1）或者提示语请求（type=2）时，该字段无效。

设备id加密说明

设备ID(deviceId)由设备端自行生成，共16位(只支持数字和字母组合，其他字符不支持)，需要保证每台设备的deviceId唯一不变，建议以 "ai" 字符开头，如ai11223344556677。为保证设备 ID 的隐私性，在数据传输过程中需要对 deviceId 进行 AES/CBC 加密,加密后的数据作为uid。

加密流程
取ApiKey前16个字符作为密钥偏移量aes_iv,配合AESKey(Secret)使用AES/CBC算法进行加密。加密具体实现算法参考附录中的uid生成demo部分。

Token说明

Token的获取和更新

首次请求token值可以为空，之后的请求分为流式识别和非流式识别两种情况。流式识别过程中（index非负数时）返回的token为请求时携带的token值，若请求时不携带则不返回，流式识别最后一次请求（index为负数）后会返回正确的token，随后的每次请求均要携带token。非流式识别每次请求后都会返回token，随后的每次请求均要携带token。总结起来只有一句话：每次请求token值使用上次请求返回的token值。

Token有效期

目前是10分钟的有效期，后期可能会根据业务需要随时变动。只要开发者遵循一个原则“每次请求token值使用上次请求返回的token值”，token有效期对接口调用无任何影响。

Token更新建议

针对请求要求“每次请求token值使用上次请求返回的token值”，所以每次请求都需要刷新token，而且在退出程序之后做持久化处理。建议刷新token只在内存中刷新，当程序退出或设备关机时将最后一次token保存在数据存储区。另外，开发者不用担心token过期问题，本接口为提升用户体验，已经做token容错处理，即每个token有效周期内允许接口调用过程中允许5次token错误请求，并在该5次请求中都会返回正确的token用于客户端更新本地token，即已经做了容错处理。所以不用担心当程序异常退出之后，token过期造成服务无法正常使用问题。

tone音色说明

值	音色说明
20	智娃，男童，情感TTS
21	阿Q，女童，情感TTS
22	慧听，成年女声，情感TTS

调用样例

POST /speech/chat  HTTP/1.1
Host: smartdevice.ai.turingapi.com
Connection: keep-alive
Content-Length: 26899
Cache-Control: no-cache
Content-Type: multipart/form-data; boundary=----WebKitFormBoundarybtXd96AztrPD9eZT
Accept: */*
Accept-Encoding: gzip, deflate
Accept-Language: zh-CN

------WebKitFormBoundarybtXd96AztrPD9eZT
Content-Disposition: form-data; name="parameters"

{
    "ak": "8268ff3b******c7b10a6d49a0fddcd5",
    "uid": "9C5DE14C6503BCF56821D7A41DA23B4D",
    "asr": 1,
    "tts": 1,
    "token": "2af62825b9cd49568cc55a6256a86239",
    "flag": 3
}
------WebKitFormBoundarybtXd96AztrPD9eZT
Content-Disposition: form-data; name="speech"; filename="pcm_8K_16bit_test.pcm"
Content-Type: application/octet-stream

二进制文件内容区
------WebKitFormBoundarybtXd96AztrPD9eZT--

返回结果

{
    "asr": "讲个故事。",
    "code": 20008,
    "emotion": 0,
    "func": {
        "author": "",
        "duration": 151,
        "id": 3853,
        "originalAuthor": "",
        "originalTitle": "",
        "tip": "http://turing-iot.oss-cn-beijing.aliyuncs.com/audio/nlp-8268ff3b******c7b10a6d49a0fddcd5-8420a211db3d4560b3b4f59eacc30d90.mp3",
        "title": "胸有成竹",
        "url": "http://zzya.beva.cn/dq/FmUSZwvL7wxd5obcexnvMzdDEnAQ.mp3"
    },
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/audio/nlp-8268ff3b******c7b10a6d49a0fddcd5-54ceafa7bef04c7a8105a37f9a37f733.mp3"
    ],
    "token": "1f1e5ff699654a7ca91cbacd10df91ea",
    "tts": "好的，接下来我给你讲个故事，故事名字叫胸有成竹",
    "ver": "1.52"
}

返回参数

字段	类型	说明
code	int	返回码: 2xxxx 功能码； 4xxxx 错误码
token	String	请求令牌
nlp	Array	分段音频输出，具体含义根据请求type定义：当type=0时：普通聊天音频；当type=1时：主动交互音频；当type=2时：开机等提示语音频
asr	String	语音识别文本结果，根据输入字段flag控制是否输出
tts	String	语义解析文本结果，根据输入字段flag控制是否输出
func	json	返回类型及对应数据结构根据功能码定义，详细参考功能码列表
action	int	知识库中设置的动作
emotion	int	情绪ID返回数据，具体ID情绪ID对应表；如果在知识库中设置表情，会覆盖系统返回的表情值
ver	String	版本号

TuringOs技能说明

儿童聊天(20000)

技能描述

儿童聊天基于图灵亿万级别的儿童语料库，回答活泼自然且正能量，在用户与机器人闲聊时，用户询问机器人一句话，机器人会通过对话语的理解返回相应的回答，并且回答符合儿童的聊天交互，语言温和恰当。

图灵在儿童聊天上提供了对交互用户的基本信息的记忆功能，信息会记录在图灵云端，丰富交互的乐趣。目前的记忆能力包括对姓名、年龄、性别、星座的记忆。重复告知机器人信息，第二次会覆盖第一次的信息。

普通结果示例

我们做朋友吧

{
    "code": 20000,
    "tts": "好呀我们是好盆友",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-ba7218e75f05457d87e0fa550963166e.mp3"
    ],
    "token": "f4e1ba55def449d59597a26cb54b750a",
    "emotion": 0
}

记忆能力结果示例

我是小肖

{
    "code": 20000,
    "tts": "好吧，那我以后叫你小肖了哦～",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-8209c6cd661a46a7ae8fe40fd04b979a.mp3"
    ],
    "token": "f4e1ba55def449d59597a26cb54b750a",
    "emotion": 0
}

我是谁

{
    "code": 20000,
    "tts": "你是小肖啊，人家怎么可能忘记啦～",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-7ee0dd5095c044eb8967cb1167e792fb.mp3"
    ],
    "token": "f4e1ba55def449d59597a26cb54b750a",
    "emotion": 21500
}

成语接龙(20000)

技能描述

成语接龙是图灵提供的学习成语的小游戏。接龙采用积分的形式，回答错误会继续进行，可以获取提示，成语有三次跳过的机会，三次跳过后会结束游戏并公布分值。此技能为多轮技能，记得退出哦。

使用说明

指令功能	指令词
进入语	成语接龙、我想玩成语接龙、进入成语接龙
正常回答	守口如瓶
提示答案	提示、提示一下
切换题目	换一个、换题、跳过
退出游戏	不玩了、退出游戏、退出

结果示例

成语接龙

{
    "code": 20000,
    "tts": "欢迎进入“成语接龙”游戏，接不上了可以跟我说“提示”、 “换题”或“跳过”； 不想玩了可以对我说 “退出” 。让我见识见识你的厉害。请接：杜门自守",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-c38a78c25144458aa4e348d00e004f6d.mp3"
    ],
    "token": "97cb744d38ff41599d7d762e97888a7c",
    "emotion": 0
}

守口如瓶

{
    "code": 20000,
    "tts": "厉害哦，竟然没难倒你。得1分。看我的：【萍踪浪影】",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-b1914ad4aeea411786fa0570a78bfda7.mp3"
    ],
    "token": "97cb744d38ff41599d7d762e97888a7c",
    "emotion": 0
}

提示一下

{
    "code": 20000,
    "tts": "答不对的画面虽然很美，但向我要提示的画面更美。看提示：[蝇~~利, 英才~~, 硬~头~, 应~而~]",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-7ff2199444df4c40b4234725633840c5.mp3"
    ],
    "token": "97cb744d38ff41599d7d762e97888a7c",
    "emotion": 0
}

换一个

{
    "code": 20000,
    "tts": "是谁在呼唤我换题~是你这个笨笨的人类啊。你要的题来啦：英才大略",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-91a5e80f3e8548fa819578f1776c4d99.mp3"
    ],
    "token": "6b9d8e7dc008457dbe75733bf9b218dd",
    "emotion": 0
}

不玩了

{
    "code": 20000,
    "tts": "听你哒，咱们就到这吧~~你这一轮总共答对了1道题!",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-e590dbcfc79b476b94ab38153822ce87.mp3"
    ],
    "token": "6b9d8e7dc008457dbe75733bf9b218dd",
    "emotion": 0
}

笑话(20000)

技能描述

笑话技能是图灵提供的日常小技能，可以让机器人讲一个笑话。笑话是文字的形式返回。

说法示例

1. 讲个笑话

结果示例

讲个笑话

{
    "code": 20000,
    "tts": "突然想到高二时的班主任，姓庄，外号庄B，有一天上课，一同学玩手机被他逮到，没收了那同学的手机拿在手上玩，过了大概三分钟，庄B来，把锁给我打开我们班爆笑~",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-8ff43f589b6b45d6a08affe2a66357b7.mp3"
    ],
    "token": "05e02c8cc1a64ef6b97db4cae5f46ffd",
    "emotion": 0
}

绕口令(20000)

技能描述

绕口令是图灵提供的日常小技能，可以让机器人讲一个绕口令。绕口令是文字的形式返回。

说法示例

1. 讲个绕口令

结果示例

讲个绕口令

{
    "code": 20000,
    "tts": "有个好孩子，拿张图画纸，来到石院子，学画石狮子。一天来画一次石狮子，十天来画十次石狮子。次次画石狮子，天天画石狮子，死狮子画成了“活狮子”。",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-213f594e7d644cacadc0ff8304a0d250.mp3"
    ],
    "token": "b1a9735fa1a449ec9161d3f339fa3664",
    "emotion": 0
}

顺口溜(20000)

技能描述

顺口溜是图灵提供的日常小技能，可以让机器人讲一个顺口溜，顺口溜是文字的形式返回。

说法示例

1. 讲个顺口溜

结果示例

讲个顺口溜

{
    "code": 20000,
    "tts": "雪中送炭是朋友，锦上添花是哥们；有难同当是兄弟，心有灵犀是知己。",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-251397a212b9452b8f8df5bc3e93b6bc.mp3"
    ],
    "token": "c1f2ff39ea1245cd8da12658d61f5426",
    "emotion": 0
}

脑筋急转弯(20000)

技能描述

脑筋急转弯是图灵提供的日常小技能，有两轮交互。可以让机器人出一个脑筋急转弯，机器人会先给出问题，在用户说“答案”后，机器人会返回答案。

说法示例

两轮交互：
1. 说个脑筋急转弯
2. 答案

结果示例

说个脑筋急转弯

{
    "code": 20000,
    "tts": "问：小莫是个出了名的仿冒名牌大王，为什么他却能消遥法外而又名利双收呢？想知道答案吗？请对我说：“答案”。",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-a25f9b716df6490c8070025d3506a889.mp3"
    ],
    "token": "b1a9735fa1a449ec9161d3f339fa3664",
    "emotion": 0
}

答案

{
    "code": 20000,
    "tts": "答：因为她模仿的是别人的声音",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-1a9f1095c92f4990a90c997729845292.mp3"
    ],
    "token": "b1a9735fa1a449ec9161d3f339fa3664",
    "emotion": 0
}

维基百科(20000)

技能描述

维基百科是图灵基于自身知识库，并结合维基百科的适合百科内容，搭建的百科问答能力。

说法示例

1. 深圳简介
2. 周杰伦是谁

结果示例

深圳简介

{
    "code": 20000,
    "tts": "深圳，中国四大一线城市之一，广东省辖市，地处广东省南部，珠江三角洲东岸。深圳是中国改革开放建立的第一个经济特区，是中国三大全国性金融中心之一。",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-8b489b7d8acc4eba8cb1af1e25b2ac43.mp3"
    ],
    "token": "4198804ec2904ffd8c5f8e912b784f97",
    "emotion": 0
}

休眠(20001)

技能描述

休眠指令是图灵提供给用户的控制指令，图灵解析用户的语言并返回休眠指令给前端做处理。

说法示例

1. 睡觉吧
2. 再见
3. 拜拜

结果示例

再见

{
    "code": 20001,
    "tts": "再见，我会想你的。",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-54fd3b6b74934e60bbc35bf07687aaa3-0ca9f935fc37436bb4f03c184f1472f2.mp3"
    ],
    "token": "cfe9185651c342d8857188c249b3d8fa",
    "emotion": 0
}

音量控制(20002)

技能描述

音量控制技能主要是对音量进行控制。

说法示例

1. 增大音量、减小音量
2. 大点声音、小点声音
3. 将声音调节到最大、将声音调节到最小

结果示例

增大音量

{
    "code": 20002,
    "tts": "我稍微大声点。",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-8fa7a18c19934df8a224b096959494d0.mp3"
    ],
    "token": "1b35fca11fee4bc191478615df2be976",
    "func": {
        "operate": 1,
        "arg": 10
    },
    "emotion": 0
}

将声音调节到最大

{
    "code": 20002,
    "tts": "调整到最大音量",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-254ad7f89b114583883f66df2a420461.mp3"
    ],
    "token": "1b35fca11fee4bc191478615df2be976",
    "func": {
        "volumn": 1,
        "operate": 1,
        "arg": 10
    },
    "emotion": 0
}

字段说明

参数	类型	是否必须	说明
operate	int	Y	操作码： 0-减小音量； 1-增大音量
arg	int	Y	操作命令字段，此处表示音量值: 默认值10
volumn	int	N	这个参数只会出现在音量最大和音量最小的口令中,此时无需关注上述两个参数： volumn=1,表示将音量调到最大； volumn=-1,表示将音量调到最小。

天气查询(20003)

技能描述

天气查询是图灵提供的一套天气查询能力，可以查询国内各地区的天气，并且可以查询今天、明天、后天等时间的天气，且具有上下文的能力。

天气查询的逻辑：

没有使用extra扩展参数请求时：当没有携带相应城市名称信息时，会反问用户在哪个城市，收到城市名称后，会报出当前天气。

当使用了extra扩展参数请求时：支持在每次请求时携带含有城市名、GPS经纬度、IP的相关信息。这时询问天气时，如果请求是“北京天气如何”，会返回北京的天气信息，如果请求是“今天天气怎么样”，会按照extra扩展参数中上传的信息返回相应天气信息。当请求中携带了上述信息时，会按照如下优先级查询天气：请求中携带地址>城市名>经纬度>IP。

说法示例

携带城市名称信息:
1. 深圳天气怎么样
2. 明天深圳天气怎么样

未携带城市名称信息:
a. 上海今天天气怎么样
b. 深圳
c. 明天

结果示例(携带城市名称信息)

深圳天气怎么样

{
    "code": 20003,
    "tts": "深圳市今天多云，19到30摄氏度，持续无风向微风。PM2.5指数22。天气热，建议着短裙、短裤、短薄外套、T恤等夏季服装。",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-850709ea4d844c69b8e2601b69d2c5d8.mp3"
    ],
    "token": "e3feb21dd102475a9c75fcf19b95914d",
    "emotion": 0
}

结果示例(未携带城市名称信息)

今天天气怎么样

{
    "code": 20003,
    "tts": "请告诉我你在哪个城市。",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-573f9f6108ef44f5a4f8f31110c5bf73-057302c3519640889c85b42b983a83c7.mp3"
    ],
    "token": "e3feb21dd102475a9c75fcf19b95914d",
    "emotion": 0
}

深圳

{
    "code": 20003,
    "tts": "深圳市今天多云，19到30摄氏度，持续无风向微风。PM2.5指数22。天气热，建议着短裙、短裤、短薄外套、T恤等夏季服装。",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-850709ea4d844c69b8e2601b69d2c5d8.mp3"
    ],
    "token": "e3feb21dd102475a9c75fcf19b95914d",
    "emotion": 0
}

AI-WIFI利用扩展参数请求

parameters 字段

参数	类型	必选	说明
extra	json	N	扩展字段

extra 字段说明

参数	类型	必选	说明
weatherCity	String	N	城市名
weatherlatitude	String	N	纬度
weatherlongitude	String	N	经度
weatherIp	String	N	ip地址

带extra扩展参数请求示例

今天天气怎么样

{
    "ak": "e15222a3dbc04360******060c43c3b8",
    "uid": "f682eabb647ab913b7245bd1b70d9cf2",
    "token": "0ff60c27e46942a389a9c047b7bed310",
    "asr": 0,
    "tts": 3,
    "tone": 20,
    "flag": 3,
    "type": 5,
    "textStr": "今天天气怎么样",
    "extra": {
        "weatherCity": "深圳",
        "weatherlongitude": "113.9567842900",
        "weatherlatitude": "22.5381904200",
        "weatherIp": "58.250.250.202"
    }
}

日期查询(20005)

技能描述

日期查询是图灵提供的一套查询日期的能力，包括对日期的查询、对阳历阴历的查询、对节日的查询、对星期的查询。

说法示例

1. 今天是几号
2. 今天是周几
3. 端午节是哪一天
4. 八月二十五日的阴历

结果示例

今天是几号

{
    "code": 20005,
    "tts": "今天是2020年4月29日。",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-c9b12d0745fb43489b91763e7bcd7983-cea34b5f721f402b9f920ff4a1164384.mp3"
    ],
    "token": "6671c7c7ba3f4352aa559887270470c1",
    "emotion": 0
}

时间查询(20005)

技能描述

时间查询是图灵提供的查询时间的功能，可以查询现在的北京时间。

说法示例

1. 现在是几点
2. 几点了

结果示例

现在是几点

{
    "code": 20005,
    "tts": "现在时间是2020年4月29日19点42分。",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-5518294fd89c48629d8862169f808a34.mp3"
    ],
    "token": "cfe9185651c342d8857188c249b3d8fa",
    "emotion": 0
}

四则运算(20006)

技能描述

四则运算是图灵提供的算数能力，可以进行简单的加减乘除运算，并且可以通过多轮对话进行多轮运算。

说法示例

单轮：
1. 一加一等于几
2. 二乘以三等于多少

多轮：
1. 一加二等于几
2. 再乘以三呢

单轮结果示例

一加一等于几

{
    "code": 20006,
    "tts": "一加一等于二",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-573f9f6108ef44f5a4f8f31110c5bf73-7664eb760ca74f3ba1d6ffcd330408ef.mp3"
    ],
    "token": "5c30fc5f5a374c3089c0c2487201a1e0",
    "emotion": 0
}

多轮结果示例

一加二等于几

{
    "code": 20006,
    "tts": "一加二等于三",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-a92cd3571e3d489fa9ff45337d290c20.mp3"
    ],
    "token": "5c30fc5f5a374c3089c0c2487201a1e0",
    "emotion": 0
}

再乘以三呢

{
    "code": 20006,
    "tts": "三点零乘以三等于九",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-a2ada0427fcb497e8d1f72e4bddaa49c.mp3"
    ],
    "token": "5c30fc5f5a374c3089c0c2487201a1e0",
    "emotion": 0
}

歌曲点播(20007)

技能描述

歌曲点播是图灵提供的一套歌曲播放的能力。

使用说明

点播指令	示例
随机播歌	我想听歌、唱首歌
多轮操作	唱首歌、下一首、上一首、单曲循环、暂停播放、继续播放、停止

结果示例

我想听流行歌曲

{
    "code": 20007,
    "tts": "好的，我要开始唱找朋友这首歌啦",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-231a71e28a6549f49296cf8ee9ea7aed.mp3"
    ],
    "token": "73c3ba5695c64c1082a8a56f864f5767",
    "func": {
        "duration": 0,
        "operate": 1000,
        "singer": "",
        "originalTitle": "",
        "originalSinger": "",
        "isPlay": 1,
        "tip": "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-c99ba01db25044a897fcf109b9e1c98e.mp3",
        "id": 148964,
        "title": "找朋友",
        "url": "http://iot-cdn.turingapi.com/202004301546/c4fa9fbf0bc4e3ffe66fd74054b3944f/media/audio/234670ac59e111e9b6cd60f6774f01f9.mp3"
    },
    "emotion": 0
}

字段说明

参数	类型	是否必须	说明
duration	Int	Y	持续时间，默认为0；无需关注
singer	String	Y	歌手
originalTitle	IString	Y	原始标题
originalSinger	String	Y	原始歌手
isPlay	Int	Y	表示返回的音乐资源是否可以播放,如果需要播放音乐资源时，使用这个字段判断一下，资源是否可以播放： isPlay=0，表示音乐资源不能播放； isPalay=1，表示音乐资源可以播放；
tip	String	Y	合成的音乐标题title的音频地址
id	Int	Y	音频文件的id；无需关注
title	String	Y	音乐标题
url	String	Y	音乐音频地址
operate	Int	Y	operate=1000，表示普通命令的请求播放音乐； operate=2002时，表示停止音乐的命令； operate=2005，表示通过上一首的命令请求音乐播放； operate=2006时，表示通过下一首的命令请求音乐； operate=3002时，表示单曲循环播放音乐； operate=1200时，表示暂停播放； operate=1300时，表示继续播放;

故事点播(20008)

技能描述

故事点播是图灵提供的一套故事播放的能力。

使用说明

点播指令	示例
随机点播	我想听故事、讲个故事
多轮操作	讲个故事、下一个、上一个、单曲循环、暂停、继续、停止

结果示例

我想听故事

{
    "code": 20008,
    "tts": "我要开始讲故事了。",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-a7601fe0d18842acb88b1c2f39eccf9b.mp3"
    ],
    "token": "3f3048d1423c40fe92fcc197480a3aa7",
    "func": {
        "duration": 0,
        "operate": 1000,
        "author": "",
        "originalTitle": "",
        "isPlay": 1,
        "tip": "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-ad1c2fcb204d476eaf4b7c2f5420d345.mp3",
        "id": 68162,
        "title": "",
        "originalAuthor": "",
        "url": "http://iot-cdn.turingapi.com/202004301614/736c34ac8aafc986ca8fe28b7a9d65e5/media/audio/20180524/1324bc64ef5643fb96aad4bff67b01b1.mp3"
    },
    "emotion": 0
}

字段说明

参数	类型	是否必须	说明
duration	Int	Y	持续时间，默认为0；无需关注
author	String	Y	作者
originalTitle	IString	Y	原始标题
originalAuthor	String	Y	原始作者
isPlay	Int	Y	表示返回的故事资源是否可以播放，如果在需要播放故事资源时，使用这个字段判断一下资源是否可以播放： isPalay=1,表示故事资源可以播放； isPlay=0,表示故事资源不能播放:
tip	String	Y	故事标题title的音频地址
id	Int	Y	音频文件的id；无需关注
title	String	Y	故事标题
url	String	Y	故事音频地址
operate	Int	Y	operate=1000时，表示普通命令的请求讲故事； operate=2005时，表示通过上一个的命令请求讲故事； operate=2006时，表示通过下一个的命令请求讲故事； operate=2002时，表示停止讲故事的命令；当operate=3002时，表示单曲循环讲故事；当operate=1200时，表示暂停讲故事; operate=1300时，表示继续播放;

诗词背诵(20009)

诗词背诵

诗词背诵是图灵提供的一套诗词学习能力，可以让机器人背诵各朝各代的诗词，可以询问诗词的作者、诗词的上下句等。当诗词有音频资源（即朗诵版）时，图灵会优先返回音频资源的朗读，如果没有则会返回诗词的文字。

使用说明

指令	示例
背诵诗词	背诵静夜思
询问作者	登鹳雀楼的作者是谁
类型背诵	背诵一首唐诗
作者点播	背诵杜甫的诗
询问上下句	举头望明月的上一句是什么

结果示例

背诵静夜思

{
    "code": 20009,
    "tts": "静夜思 唐代 李白 床前明月光，疑是地上霜。举头望明月，低头思故乡。",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-133ba4af62d14b0d9a7dc26ad6d70064.mp3"
    ],
    "token": "3135c796ffc34f27acafd5eb92b3c026",
    "func": {
        "title": "静夜思",
        "author": "李白"
    },
    "emotion": 0
}

字段说明

参数	类型	是否必须	说明
year	String	Y	年代
author	String	Y	作者

动物叫声(20011)

技能描述

动物叫声是模仿动物叫声的一个趣味小应用。

说法示例

1. 狗的叫声

结果示例

狗的叫声

{
    "code": 20011,
    "tts": "狗的叫声",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-2e67afc057ae4b75a1e869b45281f411.mp3"
    ],
    "token": "958d45e9f114450392efd974ebb89466",
    "func": {
        "animal": "狗",
        "url": "http://iot-cdn.turingapi.com/202004281930/2e00cc347091a459c664b72b8b7d9cbb/media/audio/2018-10-16/de27ffec-d50f-414b-9a06-ac0e282881ad.mp3"
    },
    "emotion": 0
}

字段说明

参数	类型	是否必须	说明
animal	String	Y	动物名称
url	String	Y	动物声音音频地址

十万个为什么(20012)

技能描述

基于图灵的知识图谱与专属教育知识库构建的十万个为什么问答。

说法示例

1. 水为什么是蓝色的
2. 人为什么要喝水

结果示例

水为什么是蓝色的

{
    "code": 20012,
    "tts": "太阳光是由红、橙、黄、绿、青、蓝、紫七种颜色的光组成的。当太阳光照射到大海上,红光、橙光这些波长较长的光,能绕过一切阻碍,勇往直前。它们在前进的过程中,不断被海水和海里的生物所吸收。而像蓝光、紫光这些波长较短的光,虽然也有一部分被海水和海藻等吸收,但是大部分一遇到海水的阻碍就纷纷散射到周围去了,或者干脆被反射回来了。我们看到的就是这部分被散射或被反射出来的光。海水越深,被散射和反射的蓝光就越多,所以,大海看上去总是碧蓝碧蓝的。",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-1e407ee1ba2f40d48373f539460f717d.mp3",
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-9f72e54b21be4b38ab594ecef1f4d629.mp3"
    ],
    "token": "e8fc5d9a0ef9469dad72304b4c34c510",
    "emotion": 0
}

打电话(20013)

技能描述

打电话功能是图灵提供的拨打电话的解析能力，可以给号码拨打，也可以给姓名拨打，图灵会返回相应的号码或姓名的解析结果。可配合电话速记技能使用，电话速记技能开通请联系商务。

说法示例

1. 打电话给100xx
2. 打电话给爸爸

结果示例

打电话给100xx

{
    "code": 20013,
    "tts": "正在拨打100xx",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-7759681ba9c349fea9b4d6cdc790687a.mp3"
    ],
    "token": "18a9585590c8464895db7f739ae51906",
    "func": {
        "address_list": [
            {
                "name": "100xx",
                "pinyin": null,
                "receiver": "100xx"
            }
        ]
    },
    "emotion": 0
}

打电话给爸爸

{
    "code": 20013,
    "tts": "正在拨打给爸爸",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-03a192c8e18c4c3fafea62d0368d9fc7-07e1e9e4b457483694adc6e8d3396505.mp3"
    ],
    "token": "18a9585590c8464895db7f739ae51906",
    "func": {
        "address_list": [
            {
                "name": "爸爸",
                "pinyin": "ba ba",
                "receiver": ""
            }
        ]
    },
    "emotion": 0
}

字段说明

参数	类型	是否必须	说明
name	String	Y	联系人名称
pinyin	String	Y	姓名的拼音
receiver	String	Y	号码

谁在叫(20014)

技能描述

谁在叫是图灵提供的趣味游戏，进入此游戏后，机器人会给孩子播放各类声音，然后孩子来听声音猜东西。此技能为多轮技能，不玩的时候记得退出哦。

使用说明

指令功能	指令词
进入语	谁在叫、我想玩谁在叫、进入谁在叫
正常回答	鸡叫声、鸡的叫声、鸡
公布谜底	不知道、猜不出来、答案
再听一遍	再来一次、再说一遍
切换题目	换一个
退出游戏	不玩了、退出游戏、退出

多轮结果示例

我想玩谁在叫

{
    "code": 20014,
    "tts": "小朋友，欢迎你进入‘谁在叫’闯关游戏。一会我会发出一个声音，你来猜猜它是什么声音吧，如果不想玩了，可以跟我说退出或不想玩了。准备好哦，开始闯关喽！第1关：",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-7a60e977269f4726a8cb03b8cbb684a5.mp3"
    ],
    "end": "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-16bcb1d05749434eb23f8d20e5f256c2.mp3",
    "token": "7523a65c836d49b59603249b06310daf",
    "func": {
        "url": "http://download.turingapi.com/voice/016.mp3"
    },
    "emotion": 0
}

鸡叫声

{
    "code": 20014,
    "tts": "恭喜你，答对了，答案就是公鸡的叫声,加油，加油。我们开始下一关吧！第2关：",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-59b3c69354b94a92967ee817dd319dee.mp3"
    ],
    "token": "7523a65c836d49b59603249b06310daf",
    "func": {
        "url": "http://download.turingapi.com/voice/017.mp3"
    },
    "emotion": 0
}

不知道

{
    "code": 20014,
    "tts": "听好哦，我要公布答案了，答案是狗叫的声音。我们现在进入下一关吧。第3关：",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-d9f1ab1824d04aa391f391fde9bdfc10.mp3"
    ],
    "token": "7523a65c836d49b59603249b06310daf",
    "func": {
        "url": "http://download.turingapi.com/voice/114.mp3"
    },
    "emotion": 0
}

再来一次

{
    "code": 20014,
    "tts": "好的，我们再来听一次吧:",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-d79b139162334026b5400c0b41f6d51a.mp3"
    ],
    "token": "7523a65c836d49b59603249b06310daf",
    "func": {
        "url": "http://download.turingapi.com/voice/114.mp3"
    },
    "emotion": 0
}

换一个

{
    "code": 20014,
    "tts": "第4关：",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-eac332c9ef744a1b93be84319cf7f37a.mp3"
    ],
    "token": "7523a65c836d49b59603249b06310daf",
    "func": {
        "url": "http://download.turingapi.com/voice/018.mp3"
    },
    "emotion": 0
}

不玩了

{
    "code": 20014,
    "tts": "好的，退出游戏，我们玩点别的吧。",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-a523140520f54c1cb71020a0adfaf22e.mp3"
    ],
    "token": "7523a65c836d49b59603249b06310daf",
    "func": {
        "url": ""
    },
    "emotion": 0
}

字段说明

参数	类型	是否必须	说明
url	String	Y	被猜的叫声的音频地址，退出的时候此字段值为空

中英互译(20015)

技能描述

中英互译是图灵提供的机器翻译能力，可以进行中译英和英译中。

说法示例

1. 苹果用英语怎么说
2. 把我喜欢你翻译成英语
3. apple是什么意思
4. 把orange翻译成中文

结果示例

苹果用英语怎么说

{
    "code": 20015,
    "tts": "苹果翻译成英文是：apple",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-699ab6ed9fbe4db1bb4684c88857d5d1.mp3"
    ],
    "token": "d383b278c5e542e2972df971b728e0da",
    "emotion": 0
}

跳舞(20016)

技能描述

模拟跳舞的一个小技能。

说法示例

1. 跳舞、跳个舞、跳个舞吧

结果示例

跳个舞吧

{
    "code": 20016,
    "tts": "我要开始跳了呦，和我一起吧！",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-b374ad05da0f4799bcf71e4b0143ffac.mp3"
    ],
    "token": "5e487e9f3c5d40f8a4bf3d73bb8a8038",
    "emotion": 0
}

英文对话(20018)

技能描述

图灵提供的使用英文进行对话的功能，当你输入英文的时候，返回信息也是英文。

说法示例

1. Hello
2. I love you

结果示例

Hello

{
    "code": 20018,
    "tts": "Thanks I like you a lot too my friend.",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-9c4e9c3d36cd4fe29ff7a5bed02d542c.mp3"
    ],
    "token": "ed87ef3c0050404dab0142a58076503b",
    "emotion": 0
}

乐器声音(20019)

技能描述

乐器声音是机器人模仿乐器的声音的一个趣味小技能。

说法示例

1. 钢琴的声音

结果示例

钢琴的声音

{
    "code": 20019,
    "tts": "请听钢琴的声音。",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-573f9f6108ef44f5a4f8f31110c5bf73-562b246edff64ebbb36f31e9cf22d9ad.mp3"
    ],
    "token": "5e487e9f3c5d40f8a4bf3d73bb8a8038",
    "func": {
        "url": "http://iot-cdn.turingapi.com/202004291822/61b282f6b64cd4f89b59f96d28ecdb5f/media/audio/3a691b281af311e99fd860f6774f01f9.mp3"
    },
    "emotion": 0
}

字段说明

参数	类型	是否必须	说明
url	String	Y	音频地址

大自然声音(20020)

技能描述

大自然声音是机器人模仿大自然的声音的一个趣味小应用。

说法示例

1. 打雷的声音
2. 下雨的声音

结果示例

打雷的声音

{
    "code": 20020,
    "tts": "请听雷的声音。",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-e99819afe7ac4d7090f5f4765ad258f5.mp3"
    ],
    "token": "5e487e9f3c5d40f8a4bf3d73bb8a8038",
    "func": {
        "url": "http://iot-cdn.turingapi.com/202004291816/d08872a034f62134495bcb8427181a93/media/audio/20181207/fbe88e3ab5e3460884a52ab89f9b1859.mp3"
    },
    "emotion": 0
}

字段说明

参数	类型	是否必须	说明
url	String	Y	音频地址

屏幕亮度(20021)

技能描述

屏幕亮度技能主要是对屏幕亮度进行控制。

说法示例

1. 屏幕亮点、屏幕暗点
2. 增大屏幕亮度、减小屏幕亮度
3. 调高屏幕亮度、调低屏幕亮度
4. 屏幕调到最亮、屏幕调到最暗
5. 屏幕调亮、屏幕调暗
6. 屏幕太亮了、屏幕太暗了

结果示例

屏幕调到最亮

{
    "code": 20021,
    "tts": "好的",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-49d77cc715504aceb263ec5b31830aab.mp3"
    ],
    "token": "f08281bbd04849a3bcfce52403fb433f",
    "func": {
        "setting_level": "1",
        "intentType": "max",
        "operate": 1,
        "arg": 10
    },
    "emotion": 0
}

字段说明

参数	类型	是否必须	说明
setting_level	String	Y	操作命令字段，此处表示亮度值：固定为1
intentType	String	Y	屏幕调节类型： up：增大亮度/需要增加亮度（太暗了） down：减小亮度/需要减小亮度（太亮了） max：调到最亮 min：调到最暗
operate	int	Y	操作码： 0-减小屏幕亮度/最暗/太亮了 1-增大屏幕亮度/最亮/太暗了
arg	int	Y	操作命令字段，此处表示亮度值：固定为10

电量查询(20022)

技能描述

用户可根据返回的code值进行电量的相关处理。

说法示例

1. 查询电量、电量查询

结果示例

查询电量

{
    "code": 20022,
    "tts": "好的。",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-46113bf17b894c64910f2677dee92345.mp3"
    ],
    "token": "d9fe97ea97314de19256737fe5a7584d",
    "emotion": 0
}

拍照(20024)

技能描述

拍照功能是图灵提供的小能力，用于需要拍照指令的机器。

说法示例

1. 给我拍个照
2. 拍张照片

结果示例

给我拍个照

{
    "code": 20024,
    "tts": "拍照开始。",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-54fd3b6b74934e60bbc35bf07687aaa3-8bfbd323d0b14cabb8f0f6b11b0f27eb.mp3"
    ],
    "token": "4198804ec2904ffd8c5f8e912b784f97",
    "emotion": 0
}

闹钟(20025)

技能描述

闹钟是图灵提供的闹钟定制功能，可以解析设定闹钟的语句并返回需要设定的闹钟的时间、事件等参数给前端，前端通过返回的参数去进行闹钟的记忆和设置。

说法示例

1. 十分钟后叫我
2. 下午三点叫我起床
3. 每天下午三点叫我起床
4. 每周三下午三点叫我起床
5. 下午六点提醒我吃饭

结果示例

下午三点叫我起床

{
    "code": 20025,
    "tts": "好的，我会在4月28日的15点提醒你的。",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-56b49d20de074b0a891012554b85ed86.mp3"
    ],
    "token": "c237309b4f7445e1a05cef34812960eb",
    "func": {
        "cycleType": "0",
        "memoContent": "起床",
        "alarmType": "remind",
        "endDate": "2020-04-28",
        "timeLen": "",
        "action": "add",
        "alarmTag": "alarmClock",
        "time": "15:00:00",
        "startDate": "2020-04-28"
    },
    "emotion": 0
}

字段说明

参数	类型	说明
cycleType	String	是否重复： 0-不重复； 1-每天重复； 2-每周重复； 3-每月重复； 4-每年重复；
alarmType	String	闹钟类型： alarmClock-闹钟； remind-提醒； countDown-倒计时；
endDate	String	截止日期（yyyy-MM-dd）
timeLen	String	距离当前的时间长度
alarmTag	String	闹钟标签
time	String	闹钟时间（HH:mm:ss）
startDate	String	开始日期（yyyy-MM-dd）
action	String	闹钟的操作类型: add-添加； delete-删除；
memoContent	String	事件内容

打开应用(20026)

技能描述

打开应用是图灵提供的打开应用的指令，图灵会返回打开后面的应用名称和应用标识，需要先上传应用列表。

说法示例

1. 打开日历

结果示例

打开日历

{
    "code": 20026,
    "tts": "正在打开日历，请稍后。",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-fea76e75a61e492081f37f8984210855.mp3"
    ],
    "token": "d8d510f9abdd44d4a82f361c5f8eba83",
    "func": {
        "app_name": "日历",
        "app_package": "com.android.calendar"
    },
    "emotion": 0
}

字段说明

参数	类型	是否必须	说明
app_name	String	Y	应用名称
app_package	String	Y	应用标识

知识库(20027)

技能描述

基于图灵的NLU能力，精准命中用户预编写的问答对。支持相似问法扩展，并且支持通过对action、emotion的参数扩展（暂时只支持数字），来实现动作控制和表情控制。具体可在【“AI开放平台” - “机器人功能” - “知识库”】处进行编辑。

结果示例

你好呀【知识库中问答为： Q : 你好呀 A : 你的嘴真甜呢[emotion:5;action:7]】

{
    "code": 20027,
    "tts": "你的嘴真甜呢",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-9075b005acc44626b7b18fc6d648be2c.mp3"
    ],
    "token": "925a06255e75465192d0746154649949",
    "action": 7,
    "emotion": 5
}

你好呀【知识库中问答为： Q : 你好呀 A : 你的嘴真甜呢返回参数中的emotion详见情绪ID值】

{
    "code": 20027,
    "tts": "你的嘴真甜呢",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-9075b005acc44626b7b18fc6d648be2c.mp3"
    ],
    "token": "925a06255e75465192d0746154649949",
    "emotion": 10300
}

主动交互(29998)

技能描述

主动交互是图灵提供的个性化能力，当机器人在联网下的静默状态（如用户长时间没有和机器人进行交互）时，由机器人主动发起交互，可以在【“AI开放平台” - “机器人功能” - “主动交互语”】处设置相关交互语句，当达到条件后请求图灵主动交互接口时可返回设置的相应内容。注意此时的type值为1。

请求示例

{
    "ak": "e15222a3dbc04360******060c43c3b8",
    "uid": "f682eabb647ab913b7245bd1b70d9cf2",
    "token": "fc44103a69664bf49b097c29e0f5480c",
    "asr": 0,
    "tts": 3,
    "tone": 20,
    "flag": 3,
    "type": 1
}

结果示例

{
    "code": 29998,
    "tts": "小朋友你好，我们好久没聊天了哦，我想你了呢。",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-b9999782a91e438789d9232aef9a5205.mp3"
    ],
    "token": "0485c056da8c4eeb8964f0b9a4b4e4d7"
}

开机提示语(29999)

技能描述

开机提示语是图灵提供的个性化开机能力，开发者可以在硬件上设置开机时先请求开机提示语接口，这时会返回给前端一段回复，回复语和回复时间可以在【“AI开放平台” - “机器人功能” - “开机提示”】处进行编辑。注意此时的type值为2。

请求示例

{
    "ak": "e15222a3dbc04360******060c43c3b8",
    "uid": "f682eabb647ab913b7245bd1b70d9cf2",
    "token": "97cb744d38ff41599d7d762e97888a7c",
    "asr": 0,
    "tts": 3,
    "tone": 20,
    "flag": 3,
    "type": 2
}

结果示例

{
    "code": 29999,
    "tts": "这是测试的开机提示语",
    "nlp": [
        "http://turing-iot.oss-cn-beijing.aliyuncs.com/tts/tts-e15222a3dbc04360******060c43c3b8-c0a3249d9ebc4faa89039a6a2a56bb66.mp3"
    ],
    "token": "4105b538a8d14ea38182d1112985e74b"
}

主题对话

技能描述

主题对话是图灵提供给开发者的一套自定义多轮对话的工具，开发者可以基于主题对话的说明文档进行主题对话的编辑。

详见主题对话编写说明

其他技能

图灵提供一些其他的技能，并没有在所有用户的标准技能界面展现，若您需要请与图灵的商务或项目同事进行沟通，然后由他们给您开通并提供详细的接入文档。

附录

功能码

功能码	功能	说明
20000	儿童聊天、成语接龙、笑话、绕口令、顺口溜、脑筋急转弯、维基百科、	普通聊天模式
20001	休眠	口令控制设备休眠，口令：再见、拜拜等
20002	音量控制	控制当前音量大小，具体可调幅度根据设备不存在差异
20003	天气查询	支持全国660个主要城市和地区的天气查询
20005	日期查询、时间查询	查询目标地区当前日期时间
20006	四则运算	支持1000以内的四则混合运算
20007	歌曲点播	支持随机播放与点播歌曲
20008	故事点播	支持随机播放与点播故事
20009	诗词背诵	支持5000余首古诗朗诵
20011	动物叫声	支持38种常见物叫声
20012	十万个为什么	支持107万个百科知识
20013	打电话	支持打电话功能
20014	谁在叫	猜动物叫声游戏
20015	中英互译	中文翻译英文，英文翻译中文
20016	跳舞	命令机器人跳舞
20018	英文对话	用英文进行对话
20019	乐器声音	播放乐器的声音
20020	大自然声音	播放打雷等大自然的声音
20021	屏幕亮度	调整屏幕亮度
20022	电量查询	暂不支持
20024	拍照	发出拍照指令
20025	闹钟	设置闹钟或提醒
20026	打开应用	打开应用，需要上传应用列表
20027	知识库	智能FAQ，需设置知识库
20039	绘本	绘本技能type=4
29998	主动交互	机器人长时间无交互由机器人主动交互
29999	开机提示语	开机等场景下的提示语
20030	四步学诗词	诗词学习小技能（非默认技能）

错误码

错误代码	返回msg	详细描述
40000	in progress	正在进行流式识别
40001	value error	字段错误
40002	illegal value	非法字段
40003	value is null or missing	字段为空或错误
40004	asr failure	语音解析失败（音频内容识别为空）
40005	tts failure	文本转语音失败
40006	nlp failure	语义解析失败
40007	token invalid value	无效token
40008	is expired	过期
40010	active interaction corpus not exist	主动交互语料不存在
40011	greeting corpus not exist	打招呼语料不存在
40012	request is forbidden	拒绝请求
40013	out of device count limit	请求超出限制
40020	speech is null	speech 数据不能为null
42000	synthetic tts text is null	合成tts的文本为null
43000	asr io read error	读取asr上传音频流失败
43010	asr service outime	ASR服务器端超时
43020	asr client outime	ASR客户端超时
43030	asr exception	ASR识别抛异常
43035	file exceed the limit	流式识别，每包单个音频大小超过了规定长度(20KB)
43036	file exceed the limit no realtime	非流式识别，上传音频大小超过了规定长度(360KB)
43037	file package more index > 30	一次流式识别分段上传的包不能超过30个
43038	index %s has fail	表示流式识别中在第几段已经失败了
43040	asr jt error	ASR的服务返回错误
43041	asr wait for data 5s	asr等待数据5s还没有新数据过来
43042	streaming a single packet of voice over 4s	流式传输单包语音超过4s
43043	not streaming a single packet of voice over 20s	非流式传输语音超过20s
44010	asr ali idle too long time	流式上传的音频间隔超过了10s
47100	text is null	textStr 上传不能为null
47110	text length more 50	textStr 文本输入的长度不能大于50个字符
47211	nlp user information not found	未找到用户信息
47212	nlp request is missing or too long	请求内容缺失或过长
47214	nlp deviceId request limit exceeded	deviceId请求次数超限制
47215	nlp no tick applied	没有勾选应用
47217	nlp request is malformed	请求格式错误
47218	nlp permission verification failed	权限验证失败
47310	robot count day_limit_exceeded	超过了每天的请求数量
47320	robot count hour_limit_exceeded	超过了每小时的请求数量
47330	robot count minute_limit_exceeded	超过了每分钟的请求数量
47340	no picture book permission	没有绘本权限（使用绘本中正式环境2地址时)
49999	unknown error	未知错误

情绪ID

情绪ID	情绪说明
10100	惊讶
10200	兴奋
10300	开心
10400	自信
10500	放松
10600	疲劳
10800	好奇
10900	渴望
11000	期待
11200	警惕
20600	昏睡
20500	不满
20400	厌恶
20300	不悦
20200	愤怒
20100	生气
20800	紧张
20900	恐惧
21000	沮丧
21100	失望
21200	焦虑
21300	无聊
21500	疑惑

C语言版Demo

可使用本demo体验aiwifi接入效果，仅供参考，不建议直接用在设备上。点击下载

uid生成Demo

java版本：点击下载
c版本：点击下载
python版本：点击下载