实时短语音识别 API 简介

概念解释

实时短语音识别：针对短音频（时长小于等于 60 秒），实时返回结果。适用于简短的语音指令、快速的消息记录，或其他类型的短语音片段，确保了在各种短语音交互场景下的高准确率和稳定性。

说明

Hi，您好，欢迎使用有道智云实时短语音识别API接口服务。

如果您想快速体验服务，建议您前往 语音识别体验中心 或者在体验中心右下侧找到小程序二维码，扫描进行体验。

本文档主要针对需要集成API的技术开发工程师，详细描述实时短语音识别能力相关的技术内容。

如果您有与我们商务合作的需求，可以通过以下方式联系我们：

商务邮箱： AIcloud_Business@corp.youdao.com

如果您对文档内容有任何疑问，可以通过以下几种方式联系我们：

客服QQ：1906538062

智云语音技术交流QQ群：861723255

联系邮箱： zhiyun@corp.youdao.com

温馨提示：

• 本文档主要针对开发人员，接入测试前需要在后台创建API应用，获取应用ID和应用密钥；如果您还没有，请按照 新手指南 获取。
• 平台向每个账户赠送50元的体验金，供用户集成前测试所用，具体资费规则详见 实时短语音识别服务报价 。

接口说明

接口地址：

wss://openapi.youdao.com/stream_shortasropenapi?{请求参数}

语音支持：

格式支持：wav（不压缩、pcm编码）

采样率：推荐16k。

编码：16bit位深的单声道

注：
发送时，第一帧需要为WAV HEADER 信息。

接口调用参数

服务接口的调用分为认证、实时通信两阶段。

1. 认证阶段

请求参数格式：
key1=value1&key2=value2&key3=value3&key4=value4

参数说明：

签名sign生成方法如下：
signType=v4；
sign=sha256(应用ID+salt+curtime+应用密钥)。

服务端通过 text message 返回 json字符串的认证结果，参数示例：

成功：

{
    "result": [],
    "action": "started",
    "errorCode": "0"
}

失败：

{
    "result": "[]",
    "action": "error",
    "errorCode": "202"
}

参数说明：

2 实时通信阶段

认证成功之后，进入实时通信阶段，此阶段客户端发送音频流和结束标识，并接收转写结果或错误。

2.1 发送音频流

此阶段客户端通过 binary message 发送音频流，内容为音频的二进制数据，此过程的发送频率将影响文字结果展示的实时性。

建议以 200ms 间隔发送音频数据，若间隔超时 15s 以上，服务端将停止识别。

2.2 发送结束标识

客户端完成所有音频数据的发送后，需发送一个特殊的 binary message 到服务端作为音频流发送结束的标识，内容为：

{"end": "true"}

注：该标识大小写敏感。
2.3 接收转写结果

交互过程中，服务端不断通过 text message 返回实时识别结果到客户端，响应结果是以json形式输出（为text message）。
识别结果示例：

{
    "result": [{
        "st": [{
            "bg": 30,
            "ed": 480,
            "ws": [{
                "w": "Have",
                "wb": 30,
                "we": 240
            }, {
                "w": "a",
                "wb": 240,
                "we": 270
            }, {
                "w": "good",
                "wb": 270,
                "we": 480
            }, {
                "w": "day.",
                "wb": 480,
                "we": 480
            }]
        }],
        "seg_id": 0
    }],
    "errorCode": "0",
    "action": "recognition"
}

识别结果 result 参数说明：

支持语言

服务配置

注意：如需上调调用量请联系技术人员咨询。

错误代码列表

常见语言Demo

Java 示例

实时短语音识别 java demo

Python 示例

实时短语音识别 python3 demo

C# 示例

实时短语音识别 c# demo

Php 示例

实时短语音识别 php demo

go 示例

实时短语音识别 go demo