短语音识别（算法编码：2202011）

协议类型：HTTPS

---

一、接入点

环境	地址
公网	https://api-maas.teleai.com.cn/aipaas/voice/v1/asr/short

• API Path：/aipaas/voice/v1/asr/short
• 请求方法：POST
• Content-Type：application/json

---

二、鉴权

采用请求头携带鉴权信息：

Authorization: <鉴权信息>

• 鉴权规则请参见：开发指南 - 签名认证方式。
• 鉴权在线生成工具：API在线签名计算工具。

请求头	必填	说明
Content-Type	是	内容类型，固定application/json
X-APP-ID	是	控制台 → 应用管理 → AppID
Device-Uuid	是	设备uuid
Authorization	是	鉴权信息

---

三、能力简介

对一分钟内的短语音进行识别。

• 支持单轨 PCM 格式录音文件识别；
• 支持调用方式：同步方式；
• 支持 8000 Hz、16000 Hz、24000 Hz、32000 Hz、44100 Hz、48000 Hz 采样率；
• 音频流的长度需控制在一分钟以内；

3.1 修订历史

修订日期	算法版本号	修订内容
2026-02-04	V2.2.0	修复业务方反馈的 bug
2025-12-13	V2.1.0	接口支持 utf8 编码
2025-11-04	v1.9	-

---

四、请求与响应

4.1 请求参数

• 请求参数：Json，Object

参数名	说明	必填	类型
req_id	请求全局唯一 ID，记录该值便于排查问题	是	string
audio_data	语音数据，经过 Base64 编码，要求 Base64 编码后大小不超过 4M，音频时长不超过 1 分钟	是	string
sample_rate	音频采样率，默认值16000 Hz	否	int
enable_punc	是否开启加标点，默认值是true	否	boolean
enable_itn	是否开启 ITN，默认值是true	否	boolean
enable_s2t	是否返回繁体中文，默认值是false	否	boolean
hotwords	热词列表	否	array

• 示例："3a87fe9793c9-4ebd-95d4-4ce2-a80c054b"

4.2 响应体

• 返回结果：成功 (200)，Json，Object

4.2.1 顶层字段

参数名	说明	必填	类型
code	状态码，⻅状态码说明	是	int
message	状态说明，⻅状态码说明	是	string
result	识别结果	是	object

4.2.2 识别结果 result

参数名	说明	必填	类型
result.sentences	句子结果列表	是	array

4.2.3 句子结果 result.sentences[]

参数名	说明	必填	类型
begin_time	该句的起始时间偏移，单位为毫秒	是	int
end_time	该句的结束时间偏移，单位为毫秒	是	int
texts	该句的识别文本结果	是	string

---

五、状态码说明

5.1 算法状态码

状态码	说明	描述	解决方法
10301	Required parameter miss	必填参数缺失	检查请求体是否符合接口协议
10302	Too many requests	并发请求过多	联系商务，增加并发
10304	Parse request body fail	请求格式错误	查看请求的 URL body 格式是否正确，参考接口文档
10503	Server connection time out	服务连接超时	联系技术人员
10607	Audio too large	音频文件过大	切分音频再进行识别
10608	Audio too long	音频过长	切分音频再进行识别
10903	Recognize failed	识别失败	联系技术人员
10000	Success	成功	执行下一步操作

5.2 公共状态码

• 接口响应的公共状态码由网关统一定义，一般用于标识鉴权失败、限流或服务异常，具体业务错误码、错误信息及排查建议请参考：开发指南-公共信息及状态码。

---

六、调用示例

请求示例

{
    "audio_data": "YAAIAA0ADQAtAFAAcABDAJcAvQB2AC0AQwA9AAQAGABLAGMANwABANH/tP+h/5X/qv+m/4f/vP/V/9P/xP/0/8f/oP/M/8v/x//v//P/GQAiAEYANwA3APn/AQAlADwA/f/4/+//5v/V/8D/5/8gACwAIwAXAMX/vv/T/+H/sP+w/5v/wv8LAEEARgA+ABcA+P/M/wgA2f/9/+z/3v8iABIAFQDz/+7/JABVACAA8",
    "req_id": "3a87fe9793c9-4ebd-95d4-4ce2-a80c054b"
}