讯飞能力平台语音识别ASR接口，AIUI接口问题

讯飞能力平台开发者，之前产于所有的开发测试，ASR接口包括AIUI接口我全部了解的，有不懂的可以评论留言，我一一回复，不需要走工单。

中文站 

• 新手指南
• 文档中心
• SDK下载
• 乐享会员
• 财务中心

控制台

|

1592230999922

• 产品服务

• 解决方案

• 行业专题

• 服务市场

• AI大学堂

• 1024

• AI大赛

• 生态平台

• 服务与支持

• 最新活动

文档中心

•  平台文档

•  语音识别

  • 语音听写

    • WebAPI文档
    • Android SDK文档
    • iOS SDK文档
    • Linux SDK文档
    • Windows SDK文档
    • Java SDK文档
    • 音频格式说明
    • 语音听写服务说明
    • HarmonyOS SDK 文档

  • 语音转写

  • 实时语音转写

  • 离线语音听写

  • 语音唤醒

  • 离线命令词识别

•  语音合成

•  语音扩展

•  自然语言处理

•  人脸识别

•  文字识别

•  图像识别

•  基础服务

•  解决方案

•  MSC API文档

• 文档中心
• 语音识别
• 语音听写
• WebAPI 文档

#语音听写（流式版）WebAPI 文档

#接口说明

语音听写流式接口，用于1分钟内的即时语音转文字技术，支持实时返回识别结果，达到一边上传音频一边获得识别文本的效果。
高阶功能-动态修正现在免费开放！多个小语种已上线！

动态修正：可到这里 动态修正效果 在线体验

• 未开启动态修正：实时返回识别结果，每次返回的结果都是对之前结果的追加；
• 开启动态修正：实时返回识别结果，每次返回的结果有可能是对之前结果的追加，也有可能是要替换之前某次返回的结果（即修正）；
• 开启动态修正，相较于未开启，返回结果的颗粒度更小，视觉冲击效果更佳；
• 使用动态修正功能需到控制台-流式听写-高级功能处点击开通，并设置相应参数方可使用，参数设置方法详见 业务参数说明 ；
• 动态修正功能仅 中文 支持；
• 未开启与开启返回的结果格式不同，详见 动态修正返回结果 ；

小语种

• 支持的语种请到语音听写 页面或控制台查看；
• 使用少数民族语言和小语种时，URL和中英文URL不同，详见 接口要求 ；
• 小语种参数设置方法详见 业务参数说明 ；

该语音能力是通过Websocket API的方式给开发者提供一个通用的接口。Websocket API具备流式传输能力，适用于需要流式数据传输的AI服务场景，比如边说话边识别。相较于SDK，API具有轻量、跨语言的特点；相较于HTTP API，Websocket API协议有原生支持跨域的优势。

原WebAPI普通版本接口(http[s]: //api.xfyun.cn/v1/service/v1/iat) 不再对外开放，已经使用WebAPI普通版本的用户仍可使用，同时也欢迎体验新版流式接口并尽快完成迁移~

#接口Demo

示例demo请点击 这里 下载。
目前仅提供部分开发语言的demo，其他语言请参照下方接口文档进行开发。
也欢迎热心的开发者到 讯飞开放平台社区 分享你们的demo。

#接口要求

集成语音听写流式API时，需按照以下要求。

内容	说明
请求协议	ws[s]（为提高安全性，强烈推荐wss）
请求地址	中英文(推荐使用)：ws[s]: //iat-api.xfyun.cn/v2/iat 中英文：ws[s]: //ws-api.xfyun.cn/v2/iat 小语种：ws[s]: //iat-niche-api.xfyun.cn/v2/iat 注：服务器IP不固定，为保证您的接口稳定，请勿通过指定IP的方式调用接口，使用域名方式调用
请求行	GET /v2/iat HTTP/1.1
接口鉴权	签名机制，详情请参照下方接口鉴权
字符编码	UTF-8
响应格式	统一采用JSON格式
开发语言	任意，只要可以向讯飞云服务发起Websocket请求的均可
操作系统	任意
音频属性	采样率16k或8K、位长16bit、单声道
音频格式	pcm speex（8k） speex-wb（16k） mp3（仅中文普通话和英文支持，其他方言及小语种敬请期待） 样例音频请参照音频样例
音频长度	最长60s
语言种类	中文、英文、小语种以及中文方言，可在控制台-语音听写（流式版）-方言/语种处添加试用或购买

#接口调用流程

• 通过接口密钥基于hmac-sha256计算签名，向服务器端发送Websocket协议握手请求。详见下方 接口鉴权 。
• 握手成功后，客户端通过Websocket连接同时上传和接收数据。数据上传完毕，客户端需要上传一次数据结束标识。详见下方 接口数据传输与接收 。
• 接收到服务器端的结果全部返回标识后断开Websocket连接。

注： Websocket使用注意事项如下

1. 服务端支持的websocket-version 为13，请确保客户端使用的框架支持该版本。
2. 服务端返回的所有的帧类型均为TextMessage，对应于原生websocket的协议帧中opcode=1，请确保客户端解析到的帧类型一定为该类型，如果不是，请尝试升级客户端框架版本，或者更换技术框架。
3. 如果出现分帧问题，即一个json数据包分多帧返回给了客户端，导致客户端解析json失败。出现这种问题大部分情况是客户端的框架对websocket协议解析存在问题，如果出现请先尝试升级框架版本，或者更换技术框架。
4. 客户端会话结束后如果需要关闭连接，尽量保证传给服务端的错误码为websocket错误码1000（如果客户端框架没有提供关闭时传错误码的接口。则无需关注本条）。