语音识别
更新时间：2026-01-22
POST
https://qianfan.baidubce.com/v2/app/instance/vop_asr
实现语音识别功能，将语音流转换为文本内容，返回识别结果文本
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
接口 URL
统一使用 https://qianfan.baidubce.com 作为 URL host，后接具体接口路径。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
app_id
string
应用的唯一标识，用于识别调用的应用实例
示例值：69a72b3f-a18c-2f02-9ba0-007beb95b315
必选
file
string
语音文件，二进制格式，需要转换为文本的语音数据
示例值：@/path/to/your/output.pcm
必选
agent_code
string
代理编码，用于标识特定的代理配置
可选
请求结构
POST /v2/app/instance/vop_asr HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: multipart/form-data
{
"app_id": "69a72b3f-a18c-2f02-9ba0-007beb95b315",
"file": "@/path/to/your/output.pcm",
"agent_code": ""
}示例代码
实现语音识别的基础调用示例
基础调用
curl -X POST "https://qianfan.baidubce.com/v2/app/instance/vop_asr" \
-H "Authorization: Bearer bce-v3/ALTAK-******ZftZDTn7/125eeb1c5e9ddc8cf3edf18ef6d03f1517ec9408" \
-H "Content-Type: multipart/form-data" \
-F "app_id=69a72b3f-a18c-2f02-9ba0-007beb95b315" \
-F "file=@/path/to/your/output.pcm" \
-F "agent_code="返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
code
string
响应状态码，标识请求处理结果
可选
message
string
响应信息，提供请求处理的详细说明
可选
request_id
string
请求的唯一标识，用于请求追踪和问题排查
示例值：eba38dc9-5c72-4c75-bac8-afe694afa600
可选
result
string
识别结果，即语音转换出的文字内容
示例值：今天天气怎么样？
可选
语音识别成功时的响应示例
成功响应
{
"code": "success",
"message": "",
"request_id": "eba38dc9-5c72-4c75-bac8-afe694afa600",
"result": "今天天气怎么样？"
}评价此篇文章