短语音识别(算法编码: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
二、鉴权
采用请求头携带鉴权信息:
2.1 标准鉴权
Authorization: <鉴权信息>
| 请求头 |
必填 |
说明 |
Content-Type |
否 |
内容类型,固定 application/json |
X-APP-ID |
否 |
取值为控制台 → 应用及API Key → 创建应用 → AppID |
Device-Uuid |
否 |
设备uuid |
Authorization |
是 |
鉴权信息 |
2.2 Bearer Token 鉴权
Authorization: Bearer <用户申请的API-KEY>
| 请求头 |
必填 |
说明 |
Content-Type |
否 |
内容类型,固定 application/json |
Device-Uuid |
否 |
设备uuid |
Authorization |
是 |
Bearer <API_KEY> |
三、能力简介
对一分钟内的短语音进行识别。
- 支持单轨 PCM 格式录音文件识别;
- 支持调用方式:同步方式;
- 支持 8000 Hz、16000 Hz、24000 Hz、32000 Hz、44100 Hz、48000 Hz 采样率;
- 音频流的长度需控制在一分钟以内;
3.1 修订历史
| 修订日期 |
算法版本号 |
修订内容 |
| 2026-04-16 |
V3.1.0 |
更换V3.2-160M模型 |
| 2026-02-04 |
V2.2.0 |
修复业务方反馈的 bug |
| 2025-12-13 |
V2.1.0 |
接口支持 utf8 编码 |
| 2025-11-04 |
v1.9 |
- |
四、请求与响应
4.1 请求参数
| 参数名 |
说明 |
必填 |
类型 |
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 |
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"
}
七、调用示例
Python
import json
import hashlib
import hmac
import time
import re
import urllib.parse
import requests
import warnings
from datetime import datetime
import logging
# 配置日志,设置日志级别为INFO,并指定日志格式
logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(levelname)s - %(message)s')
# 配置环境变量
X_APP_ID = "yourAppId"
AUTHORIZATION = "yourAuthorization"
# 请求的URL
url = "算法调用地址"
# 请求数据
request_data = {
"req_id":"3a87fe9793c9-4ebd-95d4-4ce2-a80c054b",
"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",
"enable_punc":False,
"sample_rate":0,
"enable_s2t":False,
"enable_itn":False,
"hotwords":[]
}
# 构建请求头
headers = {
"Content-Type": "application/json",
"Device-Uuid": "2018619061498245122",
"X-APP-ID": X_APP_ID,
"Authorization": AUTHORIZATION
}
def timeSimple(timestamp):
# 将时间戳转换为HH:MM:SS格式的时间字符串
dt_object = datetime.fromtimestamp(timestamp)
formatted_time = dt_object.strftime("%H:%M:%S")
return formatted_time
def send_request(url):
try:
start_time = time.time()
logging.info(f"请求路径: {url}")
logging.info(f"开始发送: {timeSimple(start_time)}")
with requests.post(
url, json=request_data, headers=headers, stream=True, verify=False
) as response:
first_packet_time = None
if response.status_code == 200:
logging.info(f"接受到返回: {timeSimple(time.time())}")
for chunk in response.iter_content(chunk_size=1024):
if chunk:
if first_packet_time is None:
first_packet_time = time.time()
logging.info(
f"Received chunk: {timeSimple(time.time())} {chunk.decode('utf-8')}"
)
end_time = time.time()
logging.info(f"Time to first byte (TTFB): {first_packet_time - start_time:.3f} seconds")
logging.info(f"Request completed in {end_time - start_time:.3f} seconds")
else:
logging.error(f"Request failed with status code {response.status_code}")
except Exception as e:
logging.error(f"An error occurred: {e}")
# 发送请求
send_request(url)
logging.info(f"headers = {headers}")
Java(使用 Java-WebSocket + FastJSON)
import cn.hutool.http.HttpRequest;
import cn.hutool.http.HttpResponse;
import com.alibaba.fastjson.JSONObject;
import java.util.HashMap;
import java.util.Map;
/**
* 为保证示例可以正常运行,请确认maven中是否存在以下依赖:
* <dependency>
* <groupId>cn.hutool</groupId>
* <artifactId>hutool-all</artifactId>
* <version>5.8.29</version>
* </dependency>
* <dependency>
* <groupId>com.alibaba</groupId>
* <artifactId>fastjson</artifactId>
* <version>1.2.83</version>
* </dependency>
*/
public class Example {
public static void example() {
try {
// 算法调用地址,请根据实际情况修改
String url = "算法调用地址";
// 设置请求头
Map<String, String> headers = new HashMap<>();
headers.put("Content-Type", "application/json");
headers.put("Device-Uuid", "2018619061498245122");
headers.put("X-APP-ID", "你实际的AppId");
headers.put("Authorization", "你实际的Authorization");
// 设置请求参数,请根据实际情况修改
String requestString = "{
" +
" \"req_id\":\"3a87fe9793c9-4ebd-95d4-4ce2-a80c054b\"",
" +
" \"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\"",
" +
" \"enable_punc\":false,
" +
" \"sample_rate\":0,
" +
" \"enable_s2t\":false,
" +
" \"enable_itn\":false,
" +
" \"hotwords\":[]
" +
"}";
// 发起HTTP请求
HttpResponse response = HttpRequest.post(url)
.headerMap(headers, true)
.body(requestString)
.execute();
// 输出响应结果
System.out.println(response.body());
} catch (Exception e) {
e.printStackTrace();
}
}
public static void main(String[] args) {
example();
}
}