跳转到主要内容
非实时

录音文件识别(Qwen-ASR)DashScope 异步

提交异步转写任务

POST
/api/v1/services/audio/asr/transcription
cURL
curl --location --request POST 'https://dashscope.aliyuncs.com/api/v1/services/audio/asr/transcription' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header "Content-Type: application/json" \
--header "X-DashScope-Async: enable" \
--data '{
  "model": "qwen3-asr-flash-filetrans",
  "input": {
    "file_url": "https://dashscope.oss-cn-beijing.aliyuncs.com/audios/welcome.mp3"
  },
  "parameters": {
    "channel_id":[
      0
    ], 
    "enable_itn": false
  }
}'
{
  "request_id": "92e3decd-0c69-47a8-xxxxxxxxxxxx",
  "output": {
    "task_id": "8fab76d0-0eed-4d20-929f-xxxxxxxxxxxx",
    "task_status": "PENDING"
  }
}

异步流程

异步转写采用提交-轮询模式:
  1. 提交任务:发送请求,服务端返回 task_id
  2. 获取结果:使用 task_id 轮询结果查询接口,直到任务完成。

SDK

  1. 调用 async_call()(Python)或 asyncCall()(Java)提交任务,返回包含 task_id 的任务对象。
  2. 使用任务对象或 task_id 调用 fetch(),SDK 会自动轮询直到任务完成或超时。

REST API

  1. 调用此接口提交任务,获取 task_id
  2. 使用 task_id 查询结果

音频格式

音频文件 URL 必须可公开访问。 channel_id 中的每个音频轨道单独计费。例如,单个文件指定 [0, 1] 会产生两次计费。

鉴权

string
header
必填

千问云 API Key。详见获取 API Key

Header 参数

enum<string>
必填

必须设置为 enable,用于异步任务提交。

enable

请求体

application/json
string
必填

模型名称。仅支持 Qwen3-ASR-Flash-Filetrans。

object
必填

输入对象。

object

附加参数。

响应

200-application/json
string

本次调用的唯一标识符。

92e3decd-0c69-47a8-xxxxxxxxxxxx
object