一句话识别

最近更新时间：2023-08-24 17:23:19 前往 Coding 编辑

导出文档

1. 接口描述

接口请求域名：winner-api.neunit.com:18053

接口请求路径： POST /cloud/asr/v1/asr_sentence

本接口适合针对一句话的短句场景进行识别

支持 pcm,wav 流。

2. 输入参数

以下请求参数列表仅列出了接口请求参数。

参数名称	必选	类型	描述
data	是	String	语音数据 base64 编码。
language	否	String	语言，中文：zh；英文：en，默认为 zh。
voice_id	否	String	音频流识别全局唯一标识，用户自己生成（推荐使用 uuid），最长128位，对于同一环境对话场景建议传入。

3. 输出参数

参数名称	类型	描述
rid	String	本次请求唯一 id。
code	Integer	状态码，成功为 0，错误为其他值。
msg	String	状态信息，成功为 OK，错误为其他信息。
data	Object	返回数据，成功状态下有值，具体结构见下文。

data 参数结构

参数名称	类型	描述
content	string	识别文本内容。
voice_id	String	音频流识别全局唯一标识。

4. 示例

示例1 成功调用接口

传入一句话音频的 base64 流

输入示例

POST / HTTP/1.1
Host: host
Content-Type: application/json
Path: /cloud/asr/v1/asr_sentence

{
  "data": "xxx",
  language: "zh",
  "voice_id": "sacu1assdnvbhldfgbl"
}

输出示例

{
    "rid": "ab8a260e-3ffe-598a-bbcb-32324bb760d3",
    "code": 0,
    "msg": "OK",
    "data": {
      "content": "test",
      "voice_id": "sacu1assdnvbhldfgbl"
    }
}

5. 开发者资源

SDK

云 API 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。

Neunit Cloud SDK for Go

6. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码	描述
10101003	参数 data 不能为空。
10101004	参数 data 解析失败。
10101005	asr 转译失败，请稍后重试。