检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
Service，简称SIS）是一种人机交互方式，用户通过实时访问和调用API（Application Programming Interface，应用程序编程接口）获取语音交互结果。例如用户通过语音识别功能，将口述音频、普通话或者带有一定方言的语音文件识别成可编辑的文本，同时也支持通过语音
严重错误响应 功能介绍 严重错误，通常指流程无法继续的情况。出现严重错误响应时，流程不再继续，服务器端会主动断连。 响应消息 表1 响应参数 名称 参数类型 说明 resp_type String 响应类型。参数值为FATAL_ERROR，表示此次合成发生不可恢复的错误。 trace_id
如何通过主账号创建一个子账号 语音交互服务服务不支持IAM细粒度划分策略，IAM账号与主账号具备相同的操作权限。 您可以使用IAM的用户管理功能，给员工或应用程序创建IAM用户，可避免分享自己的账号密码。详细创建步骤请参见创建IAM用户。 父主题： 权限类
开始识别请求响应 由于WebSocket是全双工的，因此响应就是从服务器端发送给客户端的消息，但也并不是所有的请求信息都有一条对应的响应。服务器端收到“开始识别”请求时，会给出如下响应消息，以json字符串形式放置在text message中。 响应消息 表1 响应参数 参数名 参数类型
api_calls_with_4xx_response 4xx失败调用次数 该指标用于统计接口的4xx失败调用次数。 单位：次/分钟 ≥ 0 times 接口 1分钟 api_calls_with_5xx_response 5xx失败调用次数 该指标用于统计接口的5xx失败调用次数。 单位：次/分钟 ≥ 0
严重错误响应 严重错误，通常指流程无法继续的情况。比如当出现客户端分片音频间隔超时（例如20s）。 出现严重错误响应时，流程不再继续，服务器端会主动断连。 响应消息 表1 响应参数 参数名 参数类型 说明 resp_type String 响应类型。参数值为FATAL_ERROR，表示开始识别响应。
结束识别请求响应 服务器端收到“结束识别”请求时或语音识别过程中发生错误，服务端会向客户端推送如下响应消息，以json字符串形式放置在text message中。 响应消息 表1 响应参数 参数名 参数类型 说明 resp_type String 响应类型。参数值为END，表示结束识别响应。
dataUrl 是 String 存放录音文件地址： 推荐使用华为云OBS：授权配置请参见OBS配置。 您也可以把录音文件放在自行搭建服务器上，提供下载文件的地址。URL不能使用IP地址，只能使用域名，请尽量避免中文。 audioFormat 是 String 音频格式，具体信息请参见《API参考》中录音文件识别章节。
data_url 是 String 存放录音文件地址： 推荐使用华为云OBS：授权配置请参见OBS配置。 您也可以把录音文件放在自行搭建服务器上，提供下载文件的地址。URL不能使用IP地址，只能使用域名，请尽量避免中文 audio_format 是 String 音频格式，具体信息请参见《API参考》中录音文件识别章节。
事件响应 服务器端检测到某些事件时，会给出如下响应消息，以json字符串形式放置在text message中。 响应消息 表1 响应参数 参数名 参数类型 说明 resp_type String 响应类型。参数值为EVENT，表示开始识别响应。 trace_id String 服
用与请求服务同一region的私有桶文件，如果region不一致，可考虑使用obs签名。 您也可以把录音文件放在自行搭建服务器上，提供下载文件的地址。URL不能使用IP地址，只能使用域名，请尽量避免中文。 音频转写时长受音频时长和排队任务数量影响，音频时长和理论返回时间可参见表
如何查看接口调用量 查看接口调用量 登录控制台。 选择左侧导航栏中的“总览”。在“服务监控”中查看API总调用量、调用成功量、调用失败量。 图1 接口调用量 父主题： API使用类
体验语音交互功能。 如果您是业务开发者，没有代码编写基础，您可以使用该方式体验语音交互服务的一句话识别和语音合成功能。该方式只能用于体验，不能用于开发。 通过可视化工具（如curl、Postman）发送请求调用SIS服务API。 如果您是开发初学者，有代码编写基础，对HTTP请求
0103"，错误信息提示"real name authentication missing"， 解决方案 需要用户实名认证，不然调用服务会失败，实名认证信息操作请参见实名认证介绍。 父主题： 错误码类
统计API使用量 SIS控制台支持查看API的总调用量、调用成功量、调用失败量。 图1 总览
Sec-WebSocket-Key 发送WebSocket握手请求时，包含该头域。 采用Base64编码的随机16字节长的字符序列。用来发送给服务器使用，服务器会使用此字段组装成另一个key值放在握手返回信息里发送客户端。 x3JJHMbDL1EzLkh9GBhXDw== Sec-WebSocket-Version
选择保存到本地的路径，需要具体到音频文件，如D:/test.wav。 响应参数 Python SDK响应结果为Json格式，详见表4。调用失败处理方法请参见错误码。 表4 响应结果 参数名称 是否必选 参数类型 描述 result 是 Object 调用成功时为合成语音内容，请参考表5。
String 选择保存到本地的路径。路径需具体到文件，如D:/test.wav。 响应参数 响应类为TtsCustomResponse，详见表3。调用失败处理方法请参见错误码。 表4 TtsResponse 参数名 是否必选 参数类型 说明 isSaved 否 String 是否将响应音频保存为本地文件。
volume Integer 否 音量。 取值范围：0~100 默认值：50 响应参数 响应类为RttsDataResponse，详见表5。调用失败处理方法请参见错误码。 表5 RttsDataResponse 参数名 是否必选 参数类型 说明 data 是 Array of Byte
下载OBS上的音频失败。 请检查OBS上音频是否可访问。权限配置方法请参见配置OBS访问权限。 SIS.30004 下载热词文件失败。 请检查热词是否存在。 SIS.30006 音频解码失败。 请检查音频格式是否正常，音频是否是空文件。 SIS.30007 转写引擎加载热词失败。 请检查热词是否存在。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
