AI 助理
文档备案控制台
官方文档
首页

Fun-ASR录音文件识别HTTP API参考

更新时间：
复制 MD 格式
产品详情
我的收藏

本文介绍Fun-ASR录音文件识别HTTP API的参数和接口细节。

用户指南：非实时语音识别。关于支持的音频格式、文件大小限制、时长限制等输入要求，请参见音频规格。

DashScope异步调用（Fun-ASR）

流程说明

与DashScope同步调用（一次请求、立即返回结果）不同，异步调用专为处理长音频文件或耗时较长的任务设计，该模式采用“提交-轮询”的两步式流程，避免了因长时间等待而导致的请求超时：

  1. 第一步：提交任务

    • 客户端发起一个异步处理请求。

    • 服务器验证请求后，不会立即执行任务，而是返回一个唯一的 task_id，表示任务已成功创建。

  2. 第二步：获取结果

    • 客户端使用获取到的 task_id，通过轮询方式反复调用结果查询接口。

    • 当任务处理完成后，结果查询接口将返回最终的识别结果。

服务端点

华北2（北京）

提交任务接口：POST https://dashscope.aliyuncs.com/api/v1/services/audio/asr/transcription

查询任务接口：GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}

新加坡

提交任务接口：POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/audio/asr/transcription

查询任务接口：GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}

调用时请将WorkspaceId替换为真实的Workspace ID。

重要

百炼为新加坡地域推出了业务空间专属域名 https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com，能够为推理请求提供卓越的性能和更高的稳定性，建议从 https://dashscope-intl.aliyuncs.com 迁移至新域名。

其中 {WorkspaceId} 为您的业务空间 ID，可在百炼控制台的业务空间详情页面查看。现有域名仍可正常使用。

重要

使用新版域名（https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com）提交任务时，请求体中必须包含parameters对象。即使无需设置任何参数，也必须传入空对象{}，否则任务可正常提交，但识别将失败。

请求头

参数

类型

是否必选

说明

Authorization

string

是

鉴权令牌，格式为Bearer <your_api_key>，使用时，将"<your_api_key>"替换为实际的API Key。提交任务接口和查询任务接口均需要传入。

Content-Type

string

是

请求体的媒体类型。仅提交任务接口需要传入，固定为application/json。

X-DashScope-Async

string

是

异步任务标识。仅提交任务接口需要传入，固定为enable，请勿遗漏，否则无法提交任务。

提交任务接口

提交语音识别任务。该接口异步返回，业务侧需结合查询任务接口轮询任务状态。

请求体

以下为华北2（北京）地域的URL，各地域的URL不同。

curl --location '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": "fun-asr",
    "input": {
        "file_urls": [
            "https://dashscope.oss-cn-beijing.aliyuncs.com/samples/audio/paraformer/hello_world_female2.wav"
        ]
    },
    "parameters": {
        "channel_id": [0]
    }
}'

model string （必选）

指定用于音视频文件转写的模型名。

取值范围：

  • fun-asr

  • fun-asr-2025-11-07

  • fun-asr-2025-08-25

  • fun-asr-mtl

  • fun-asr-mtl-2025-08-25

input object （必选）

输入参数对象。

属性

file_urls array[string] （必选）

音视频文件转写的URL列表，支持HTTP / HTTPS协议，单次请求仅支持1个URL。

若录音文件存储在阿里云OSS，使用RESTful API方式支持使用以oss://为前缀的临时 URL。

重要

  • 临时 URL 有效期48小时，过期后无法使用，请勿用于生产环境。

  • 文件上传凭证接口限流为 100 QPS 且不支持扩容，请勿用于生产环境、高并发及压测场景。

  • 生产环境建议使用阿里云OSS 等稳定存储，确保文件长期可用并规避限流问题。

  • 录音文件URL设置成OSS临时公网访问不通该如何处理？请求头中将X-DashScope-OssResourceResolve设为enable（不推荐该方式）。

    Java SDK或者Python SDK不支持对请求头进行配置。

parameters object （可选）

请求参数对象。

重要

使用新版域名（https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com）时，parameters为必填项。即使无需设置任何参数，也必须传入空对象{}。若省略该字段，任务可正常提交，但查询任务结果时将返回识别失败。

属性

vocabulary_id string （可选）

热词ID，此次语音识别中生效此热词ID对应的热词信息。默认不启用。使用方法请参考定制热词。

channel_id array[integer] （可选）

指定在多音轨音频文件中需要识别的音轨索引，索引从 0 开始。例如，[0] 表示识别第一个音轨，[0, 1] 表示同时识别第一和第二个音轨。如果省略此参数，则默认处理第一个音轨。

重要

指定的每一个音轨都将独立计费。例如，为单个文件请求 [0, 1] 会产生两笔独立的费用。

默认值：[0]。

special_word_filter string （可选）

指定在语音识别过程中需要处理的敏感词，并支持对不同敏感词设置不同的处理方式。详情请参见敏感词过滤。

diarization_enabled boolean （可选）

是否启用说话人分离，默认关闭。

仅适用于单声道音频，多声道音频不支持说话人分离。

启用该功能后，识别结果中将显示speaker_id字段，用于区分不同说话人。

说明

如果启用说话人分离功能，建议音频时长不超过2小时，否则可能导致识别失败或超时。

有关speaker_id的示例，请参见识别结果说明。

默认值：false。

speaker_count integer （可选）

重要

仅在开启说话人分离功能（diarization_enabled设置为true）时生效。

说话人数量参考值。取值范围为2至100的整数（包含2和100）。

默认自动判断说话人数量，如果配置此项，只能辅助算法尽量输出指定人数，无法保证一定会输出此人数。

language_hints array[string] （可选）

设置待识别语言代码。如果无法提前确定语种，可不设置，模型会自动识别语种。

系统仅读取数组中的首个值。多余值将被忽略。

点击查看支持的语言代码

  • fun-asr、fun-asr-2025-11-07、fun-asr-mtl、fun-asr-mtl-2025-08-25：

    • zh: 中文

    • en: 英文

    • ja: 日语

    • ko：韩语

    • vi：越南语

    • th：泰语

    • id：印尼语

    • ms：马来语

    • tl：菲律宾语

    • hi：印地语

    • ar：阿拉伯语

    • fr：法语

    • de：德语

    • es：西班牙语

    • pt：葡萄牙语

    • ru：俄语

    • it：意大利语

    • nl：荷兰语

    • sv：瑞典语

    • da：丹麦语

    • fi：芬兰语

    • no：挪威语

    • el：希腊语

    • pl：波兰语

    • cs：捷克语

    • hu：匈牙利语

    • ro：罗马尼亚语

    • bg：保加利亚语

    • hr：克罗地亚语

    • sk：斯洛伐克语

  • fun-asr-2025-08-25：

    • zh: 中文

    • en: 英文

返回体

{
  "output": {
    "task_status": "PENDING",
    "task_id": "c2e5d63b-96e1-4607-bb91-************"
  },
  "request_id": "77ae55ae-be17-97b8-9942--************"
}

request_id string

本次调用的唯一标识符。

output object

提交任务返回的数据。

属性

task_id string

任务ID。该ID在查询任务接口中作为string传入。

task_status string

任务状态。提交成功时返回PENDING。

查询任务接口

查询语音识别任务的执行情况和结果。建议轮询调用直至任务终态。

请求体

以下为华北2（北京）地域的URL，各地域的URL不同。

curl --location 'https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}' \
     --header "Authorization: Bearer $DASHSCOPE_API_KEY"

task_id string （必选）

重要

该参数为URL路径参数，无请求体。

查询任务需指定其ID，该ID为提交任务接口被调用后返回的task_id。

返回体

正常示例

{
  "request_id": "f9e1afad-94d3-997e-a83b-************",
  "output": {
    "task_id": "f86ec806-4d73-485f-a24f-************",
    "task_status": "SUCCEEDED",
    "submit_time": "2024-09-12 15:11:40.041",
    "scheduled_time": "2024-09-12 15:11:40.071",
    "end_time": "2024-09-12 15:11:40.903",
    "results": [
      {
        "file_url": "https://dashscope.oss-cn-beijing.aliyuncs.com/samples/audio/paraformer/hello_world_female2.wav",
        "transcription_url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/pre/filetrans-16k/20240912/15%3A11/409a4b92-445b-4dd8-8c1d-f110954d82d8-1.json?Expires=1726211500&OSSAccessKeyId=yourOSSAccessKeyId&Signature=v5Owy5qoAfT7mzGmQgH0g8C****%3D",
        "subtask_status": "SUCCEEDED"
      }
    ],
    "task_metrics": {
      "TOTAL": 1,
      "SUCCEEDED": 1,
      "FAILED": 0
    }
  },
  "usage": {
    "duration": 9
  }
}

异常示例

{
    "task_id": "7bac899c-06ec-4a79-8875-xxxxxxxxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2024-12-16 16:30:59.170",
    "scheduled_time": "2024-12-16 16:30:59.204",
    "end_time": "2024-12-16 16:31:02.375",
    "results": [
        {
            "file_url": "https://dashscope.oss-cn-beijing.aliyuncs.com/samples/audio/sensevoice/rich_text_exaple_1.wav",
            "code": "InvalidFile.DownloadFailed",
            "message": "The audio file cannot be downloaded.",
            "subtask_status": "FAILED"
        }
    ],
    "task_metrics": {
        "TOTAL": 1,
        "SUCCEEDED": 0,
        "FAILED": 1
    }
}

request_id string

本次调用的唯一标识符。

output object

查询任务返回的数据。

属性

task_id string

被查询任务的ID。

task_status string

被查询任务的状态。

说明

当任务包含多个子任务时，只要存在任一子任务成功，整个任务状态将标记为SUCCEEDED，需通过subtask_status字段判断具体子任务结果。

submit_time string

任务提交时间。

scheduled_time string

任务被调度执行的时间。

end_time string

任务结束时间。

results array[object]

每个待识别音频文件对应的子任务结果列表。

属性

subtask_status string

子任务状态。

file_url string

文件转写任务中所处理的文件URL。

transcription_url string

获取识别结果对应的链接。该链接有效期为24小时，超时后无法查询任务或通过先前查询结果中的URL下载结果。

识别结果保存为JSON文件，您可以通过上述链接下载该文件或直接通过HTTP请求读取该文件中的内容。JSON数据中各字段含义请参见识别结果说明。

code string

重要

仅当子任务失败时返回。

子任务失败的错误码。

message string

重要

仅当子任务失败时返回。

子任务失败的错误信息。

task_metrics object

任务整体执行情况统计。

属性

TOTAL integer

子任务总数。

SUCCEEDED integer

成功的子任务数。

FAILED integer

失败的子任务数。

其他接口：批量查询任务状态/取消任务

详情请参见管理异步任务：支持批量查询24小时内提交的录音文件识别任务，同时支持取消PENDING（排队）状态的任务。

识别结果说明

识别结果保存为JSON文件。

点击查看识别结果示例

{
    "file_url":"https://dashscope.oss-cn-beijing.aliyuncs.com/samples/audio/paraformer/hello_world_female2.wav",
    "properties":{
        "audio_format":"pcm_s16le",
        "channels":[
            0
        ],
        "original_sampling_rate":16000,
        "original_duration_in_milliseconds":3834
    },
    "transcripts":[
        {
            "channel_id":0,
            "content_duration_in_milliseconds":3720,
            "text":"Hello world, 这里是阿里巴巴语音实验室。",
            "sentences":[
                {
                    "begin_time":100,
                    "end_time":3820,
                    "text":"Hello world, 这里是阿里巴巴语音实验室。",
                    "sentence_id":1,
                    "speaker_id":0, //当开启自动说话人分离功能时才会显示该字段
                    "words":[
                        {
                            "begin_time":100,
                            "end_time":596,
                            "text":"Hello ",
                            "punctuation":""
                        },
                        {
                            "begin_time":596,
                            "end_time":844,
                            "text":"world",
                            "punctuation":", "
                        }
                        // 这里省略其它内容
                    ]
                }
            ]
        }
    ]
}

需要关注的参数如下：

参数

类型

说明

audio_format

string

源文件中音频的格式。

channels

array[integer]

源文件中音频的音轨索引信息，对单轨音频返回[0]，对双轨音频返回[0, 1]，以此类推。

original_sampling_rate

integer

源文件中音频的采样率（Hz）。

original_duration_in_milliseconds

integer

源文件中的原始音频时长（ms）。

channel_id

integer

转写结果的音轨索引，以0为起始。

content_duration

integer

音轨中被判定为语音内容的时长（ms）。

重要

语音识别模型服务仅对音轨中被判定为语音内容的时长进行语音转写，并据此进行计量计费，非语音内容不计量、不计费。通常情况下语音内容时长会短于原始音频时长。由于对是否存在语音内容的判定是由AI模型给出的，可能与实际情况存在一定误差。

transcript

string

段落级别的语音转写结果。

sentences

array

句子级别的语音转写结果。

words

array

词级别的语音转写结果。

begin_time

integer

开始时间戳（ms）。

end_time

integer

结束时间戳（ms）。

text

string

语音转写结果。

speaker_id

integer

当前说话人的索引，以0为起始，用于区分不同的说话人。

仅在启用说话人分离功能时，该字段才会显示于识别结果中。

punctuation

string

预测出的词之后的标点符号（如有）。

DashScope同步调用（Fun-ASR-Flash）

重要

该功能不支持SDK调用。

服务端点

华北2（北京）

POST https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation

新加坡

POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation

调用时请将WorkspaceId替换为真实的Workspace ID。

请求头

参数

类型

是否必选

说明

Authorization

string

是

鉴权令牌，格式为Bearer <your_api_key>，使用时将"<your_api_key>"替换为实际的API Key。

Content-Type

string

是

请求体的媒体类型，固定为application/json。

X-DashScope-SSE

string

是

用于控制是否以SSE流式方式返回结果。设置为enable时开启SSE流式返回模式，服务端会分多次返回中间识别结果和最终结果；设置为disable或不传该参数则仅返回最终结果。

请求体

以下为华北2（北京）地域的URL，各地域的URL不同。

非流式

curl --location --request POST 'https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation' \
     --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
     --header "Content-Type: application/json" \
     --header "X-DashScope-SSE: disable" \
     --data '{
    "model": "fun-asr-flash-2026-06-15",
    "input": {
        "messages": [
            {
                "role": "user",
                "content": [
                    {
                        "type": "input_audio",
                        "input_audio": {
                            "data": "https://dashscope.oss-cn-beijing.aliyuncs.com/samples/audio/paraformer/hello_world_female2.wav"
                        }
                    }
                ]
            }
        ]
    },
    "parameters": {
        "format": "wav",
        "sample_rate": "16000"
    }
}'

流式

curl --location --request POST 'https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation' \
     --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
     --header "Content-Type: application/json" \
     --header "X-DashScope-SSE: enable" \
     --data '{
    "model": "fun-asr-flash-2026-06-15",
    "input": {
        "messages": [
            {
                "role": "user",
                "content": [
                    {
                        "type": "input_audio",
                        "input_audio": {
                            "data": "https://dashscope.oss-cn-beijing.aliyuncs.com/samples/audio/paraformer/hello_world_female2.wav"
                        }
                    }
                ]
            }
        ]
    },
    "parameters": {
        "format": "wav",
        "sample_rate": "16000"
    }
}'

携带上下文-非流式

curl --location --request POST 'https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation' \
     --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
     --header "Content-Type: application/json" \
     --header "X-DashScope-SSE: disable" \
     --data '{
    "model": "fun-asr-flash-2026-06-15",
    "input": {
        "messages": [
            {
                "role": "assistant",
                "content": [
                    {
                        "type": "text",
                        "text": "你好啊，我是通义千问，有什么可以帮助你的？"
                    }
                ]
            },
            {
                "role": "user",
                "content": [
                    {
                        "type": "input_text",
                        "text": "你好啊"
                    }
                ]
            },
            {
                "role": "user",
                "content": [
                    {
                        "type": "input_audio",
                        "input_audio": {
                            "data": "https://dashscope.oss-cn-beijing.aliyuncs.com/samples/audio/paraformer/hello_world_female2.wav"
                        }
                    }
                ]
            }
        ]
    },
    "parameters": {
        "format": "wav",
        "sample_rate": "16000"
    }
}'

携带上下文-流式

curl --location --request POST 'https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation' \
     --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
     --header "Content-Type: application/json" \
     --header "X-DashScope-SSE: enable" \
     --data '{
    "model": "fun-asr-flash-2026-06-15",
    "input": {
        "messages": [
            {
                "role": "assistant",
                "content": [
                    {
                        "type": "text",
                        "text": "你好啊，我是通义千问，有什么可以帮助你的？"
                    }
                ]
            },
            {
                "role": "user",
                "content": [
                    {
                        "type": "input_text",
                        "text": "你好啊"
                    }
                ]
            },
            {
                "role": "user",
                "content": [
                    {
                        "type": "input_audio",
                        "input_audio": {
                            "data": "https://dashscope.oss-cn-beijing.aliyuncs.com/samples/audio/paraformer/hello_world_female2.wav"
                        }
                    }
                ]
            }
        ]
    },
    "parameters": {
        "format": "wav",
        "sample_rate": "16000"
    }
}'

Base64

可输入Base64编码数据（Data URL），格式为：data:<mediatype>;base64,<data>。

  • <mediatype>：MIME类型

    因音频格式而异，例如：

    • WAV：audio/wav

    • MP3：audio/mpeg

  • <data>：音频转成的Base64编码的字符串

    Base64编码会增大体积，请控制原文件大小，确保编码后仍符合输入音频大小限制（10MB）

  • 示例：data:audio/wav;base64,SUQzBAAAAAAAI1RTU0UAAAAPAAADTGF2ZjU4LjI5LjEwMAAAAAAAAAAAAAAA//PAxABQ/BXRbMPe4IQAhl9

    点击查看示例代码

    import base64, pathlib

# input.mp3为待识别的本地音频文件，请替换为自己的音频文件路径，确保其符合音频要求
file_path = pathlib.Path("input.mp3")
base64_str = base64.b64encode(file_path.read_bytes()).decode()
data_uri = f"data:audio/mpeg;base64,{base64_str}"
    import java.nio.file.*;
import java.util.Base64;

public class Main {
    /**
     * filePath为待识别的本地音频文件，请替换为自己的音频文件路径，确保其符合音频要求
     */
    public static String toDataUrl(String filePath) throws Exception {
        byte[] bytes = Files.readAllBytes(Paths.get(filePath));
        String encoded = Base64.getEncoder().encodeToString(bytes);
        return "data:audio/mpeg;base64," + encoded;
    }

    public static void main(String[] args) throws Exception {
        System.out.println(toDataUrl("input.mp3"));
    }
}
import base64, pathlib
import os
import requests

# input.wav为待识别的本地音频文件，请替换为自己的音频文件路径，确保其符合音频要求
file_path = pathlib.Path("input.wav")
base64_str = base64.b64encode(file_path.read_bytes()).decode()
data_uri = f"data:audio/wav;base64,{base64_str}"

url = "https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation"

headers = {
    "Authorization": f"Bearer {os.environ['DASHSCOPE_API_KEY']}",
    "Content-Type": "application/json",
    "X-DashScope-SSE": "disable",
}

payload = {
    "model": "fun-asr-flash-2026-06-15",
    "input": {
        "messages": [
            {
                "role": "user",
                "content": [
                    {
                        "type": "input_audio",
                        "input_audio": {
                            "data": data_uri,
                        },
                    }
                ],
            }
        ]
    },
    "parameters": {
        "format": "wav",
        "sample_rate": "16000",
    },
}

response = requests.post(url, headers=headers, json=payload)
print(response.status_code)
print(response.json())

model string （必选）

模型名称，固定为fun-asr-flash-2026-06-15。

input object （必选）

输入信息。

属性

messages array(object) （必选）

消息列表。包含当前待识别的音频，以及可选的对话上下文（用于提升识别效果）。

重要

上下文功能适用于ASR与大语言模型（LLM）结合的场景：将前几轮LLM的回复内容（assistant）和用户语音识别结果（user）作为上下文传入，可显著提升当前轮次的识别准确率。user和assistant消息需成对出现，且role不能设错，否则会影响识别效果。

属性

role string （必选）

消息角色。取值范围：

  • user（必选）：用户消息。type为input_audio时表示当前待识别的音频；type为input_text时表示前几轮的识别结果（可选，上下文）。

  • assistant（可选，上下文）：前几轮大语言模型的回复内容，需与user（input_text）成对出现。

content array(object) （必选）

消息内容列表。

属性

type string （必选）

内容类型。每个请求至少需要一条input_audio类型的消息。取值范围：

  • input_audio（必选）：当前待识别的音频输入（role为user），需同时传入input_audio对象。

  • input_text（可选，上下文）：前几轮用户语音的识别结果（role为user），需同时传入text字段。

  • text（可选，上下文）：前几轮大语言模型的回复内容（role为assistant），需同时传入text字段。

input_audio object （条件必选）

当type为input_audio时必填。

属性

data string （必选）

待识别音频数据。支持以下两种方式：

  • 音频文件URL：直接传入可公开访问的音频文件地址。

  • Base64 Data URI：采用Data URI格式传入Base64编码的音频数据，值由data:{MIME_TYPE};base64,前缀与Base64编码的音频数据拼接而成。支持的MIME类型包括audio/wav、audio/mp3等。

示例（URL方式）：https://example.com/audio/sample.wav

示例（Base64方式）：data:audio/wav;base64,{BASE64_ENCODED_DATA}

text string （条件必选）

当type为input_text时，填入前几轮用户语音的识别结果；当type为text时，填入前几轮大语言模型的回复内容。

parameters object （必选）

模型参数。

属性

format string （必选）

音频格式。根据实际音频格式填写，支持wav、mp3、opus等。详情请参见音频规格。

sample_rate string （可选）

音频采样率，单位Hz。例如16000表示16kHz采样率。详情请参见音频规格。

返回体

非流式

{
    "output": {
        "sentence": {
            "begin_time": 760,
            "channel_id": 0,
            "end_time": 3800,
            "sentence_end": true,
            "sentence_id": 1,
            "text": "Hello World，这里是阿里巴巴语音实验室。",
            "words": [
                {"begin_time": 760, "end_time": 1040, "fixed": true, "punctuation": "", "text": "Hello"},
                {"begin_time": 1040, "end_time": 1240, "fixed": true, "punctuation": "，", "text": " World"},
                {"begin_time": 1360, "end_time": 1880, "fixed": true, "punctuation": "", "text": "这里是"},
                {"begin_time": 1880, "end_time": 2520, "fixed": true, "punctuation": "", "text": "阿里巴巴"},
                {"begin_time": 2520, "end_time": 2840, "fixed": true, "punctuation": "", "text": "语音"},
                {"begin_time": 2840, "end_time": 3800, "fixed": true, "punctuation": "。", "text": "实验室"}
            ]
        },
        "text": "Hello World，这里是阿里巴巴语音实验室。"
    },
    "usage": {
        "duration": 4
    },
    "request_id": "40e0734d-096f-9ae3-86c1-a8c013287561"
}

流式

设置X-DashScope-SSE: enable时，服务端以Server-Sent Events协议返回识别结果。SSE事件格式如下：

id:{序列号}
event:result
:HTTP_STATUS/200
data:{JSON数据}

返回示例：

id:1
event:result
:HTTP_STATUS/200
data:{"output":{"sentence":{"sentence_id":1,"sentence_end":true,"end_time":3800,"words":[{"end_time":1040,"punctuation":"","begin_time":760,"fixed":true,"text":"Hello"},{"end_time":1240,"punctuation":"，","begin_time":1040,"fixed":true,"text":" World"},{"end_time":1880,"punctuation":"","begin_time":1360,"fixed":true,"text":"这里是"},{"end_time":2520,"punctuation":"","begin_time":1880,"fixed":true,"text":"阿里巴巴"},{"end_time":2840,"punctuation":"","begin_time":2520,"fixed":true,"text":"语音"},{"end_time":3800,"punctuation":"。","begin_time":2840,"fixed":true,"text":"实验室"}],"begin_time":760,"text":"Hello World，这里是阿里巴巴语音实验室。","channel_id":0},"text":"Hello World，这里是阿里巴巴语音实验室。"},"usage":{"duration":4},"request_id":"fc1582e4-935c-9fc2-a482-a98bf43daa69"}

request_id string

本次请求的唯一标识。

output object

输出结果。

属性

text string

当前累积的完整识别文本。

sentence object

当前句子的详细信息。

属性

sentence_id integer

句子编号，从1开始。

sentence_end boolean

是否为该句的最终结果。为true时表示该句识别完成。

begin_time integer

句子开始时间，单位毫秒。

end_time integer

句子结束时间，单位毫秒。仅在sentence_end为true时返回。

text string

当前句子的识别文本。

channel_id integer

声道编号，从0开始。

words array

词级别时间戳列表。

属性

text string

词文本。

begin_time integer

词开始时间，单位毫秒。

end_time integer

词结束时间，单位毫秒。

punctuation string

词后的标点符号。无标点时为空字符串。

fixed boolean

词是否已稳定。false表示后续事件中该词的时间戳可能调整。

usage object

用量信息。仅在sentence_end为true时返回。

属性

duration integer

已处理的音频时长，单位秒。

SSE 流式结果处理逻辑

在流式模式下，客户端需关注以下处理要点：

  1. 每收到一个SSE事件，解析data字段中的JSON。

  2. 通过output.sentence.sentence_end判断当前句子是否结束：当该值为true时，该句识别完成，词级时间戳已稳定，可作为最终结果使用；当该值为false时，识别仍在进行中，文本和时间戳可能在后续事件中更新。

  3. usage信息仅在句子结束事件中返回，可用于计量音频处理时长。

DashScope同步调用（Fun-ASR-Realtime）

重要

  • 该功能只支持北京地域。

  • 不支持SDK调用。

服务端点

POST https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation

请求头

参数

类型

是否必选

说明

Authorization

string

是

鉴权令牌，格式为Bearer <your_api_key>，使用时将“<your_api_key>”替换为实际的API Key。

Content-Type

string

是

请求体的媒体类型，固定为application/json。

X-DashScope-SSE

string

是

用于控制是否以SSE流式方式返回结果。设置为enable时开启SSE流式返回模式，服务端会分多次返回中间识别结果和最终结果；设置为disable或不传该参数则仅返回最终结果。

请求体

非流式

curl --location --request POST 'https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation' \
     --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
     --header "Content-Type: application/json" \
     --header "X-DashScope-SSE: disable" \
     --data '{
    "model": "fun-asr-realtime",
    "input": {
        "messages": []
    },
    "parameters": {
        "audio_address": "https://example.com/audio/sample.mp3",
        "format": "mp3"
    },
    "resources": []
}'

流式

curl --location --request POST 'https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation' \
     --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
     --header "Content-Type: application/json" \
     --header "X-DashScope-SSE: enable" \
     --data '{
    "model": "fun-asr-realtime",
    "input": {
        "messages": []
    },
    "parameters": {
        "audio_address": "https://example.com/audio/sample.mp3",
        "format": "mp3"
    },
    "resources": []
}'

model string （必选）

模型名称。

取值范围：

  • fun-asr-realtime（稳定版模型）

  • fun-asr-realtime-2026-02-28（即 Fun-Realtime-ASR-preview）

input object （条件必选）

输入信息。与输入音频文件URL方式（通过parameters.audio_address传入）二选一，使用Base64方式上传音频时需要填写。

属性

messages array(object) （必选）

消息列表。

属性

content array(object) （必选）

用户消息的内容。仅允许设置一组消息。

属性

audio string （必选）

待识别音频，采用Data URI格式传入Base64编码的音频数据。

使用Base64方式上传音频时需要填写。

值由data:{MIME_TYPE};base64,前缀与Base64编码的音频数据拼接而成。支持的MIME类型包括audio/wav、audio/mp3等。

示例：data:audio/wav;base64,{BASE64_ENCODED_DATA}

role string （必选）

用户消息的角色，固定为user。使用Base64方式上传音频时需要填写。

parameters object （必选）

模型参数。

属性

audio_address string （条件必选）

音频文件URL地址。与Base64方式（通过input.messages传入）二选一，使用URL方式时必填。需为可公开访问的地址。

format string （必选）

音频格式。根据实际音频格式填写，支持wav、mp3、opus等。详情请参见音频规格。

vad_enabled boolean （可选）

是否启用端点检测（VAD）。

默认为true（启用 VAD 检测）。

设为 false 时关闭 VAD 检测；但当音频时长超过 1 分钟时，系统将自动启用 VAD 检测，忽略此参数设置。

resources array （可选）

资源列表，预留字段，当前可传空数组[]。

返回体

非流式

{
    "output": {
        "sentence": {
            "begin_time": 160,
            "channel_id": 0,
            "end_time": 1680,
            "sentence_end": true,
            "sentence_id": 1,
            "text": "欢迎使用阿里云。",
            "words": [
                {"begin_time": 160, "end_time": 520, "fixed": true, "punctuation": "", "text": "欢迎"},
                {"begin_time": 520, "end_time": 880, "fixed": true, "punctuation": "", "text": "使用"},
                {"begin_time": 880, "end_time": 1280, "fixed": true, "punctuation": "", "text": "阿里"},
                {"begin_time": 1280, "end_time": 1680, "fixed": true, "punctuation": "。", "text": "云"}
            ]
        },
        "text": "欢迎使用阿里云。"
    },
    "usage": {
        "duration": 2
    },
    "request_id": "eff4c092-2289-9b43-a4cd-80e591fa90f5"
}

流式

设置X-DashScope-SSE: enable时，服务端以Server-Sent Events协议分多次返回中间识别结果和最终结果。每个SSE事件格式如下：

id:{序列号}
event:result
:HTTP_STATUS/200
data:{JSON数据}

中间结果（句子开始、词逐步增长）：

id:1
event:result
:HTTP_STATUS/200
data:{"output":{"sentence":{"sentence_id":1,"sentence_end":false,"sentence_begin":true,"words":[],"begin_time":0,"text":"","channel_id":0},"text":""},"request_id":"372d19b3-993f-9288-adf0-a99f7606bd30"}

id:2
event:result
:HTTP_STATUS/200
data:{"output":{"sentence":{"words":[{"end_time":520,"punctuation":"","begin_time":160,"fixed":false,"text":"欢迎"}],"begin_time":160,"text":"欢迎","channel_id":0,"sentence_id":1,"sentence_end":false},"text":"欢迎"},"request_id":"372d19b3-993f-9288-adf0-a99f7606bd30"}

id:3
event:result
:HTTP_STATUS/200
data:{"output":{"sentence":{"words":[{"end_time":520,"punctuation":"","begin_time":160,"fixed":false,"text":"欢迎"},{"end_time":880,"punctuation":"","begin_time":520,"fixed":false,"text":"使用"}],"begin_time":160,"text":"欢迎使用","channel_id":0,"sentence_id":1,"sentence_end":false},"text":"欢迎使用"},"request_id":"372d19b3-993f-9288-adf0-a99f7606bd30"}

最终结果（句子结束，包含usage）：

id:4
event:result
:HTTP_STATUS/200
data:{"output":{"sentence":{"sentence_id":1,"sentence_end":true,"end_time":1680,"words":[{"end_time":520,"punctuation":"","begin_time":160,"fixed":true,"text":"欢迎"},{"end_time":880,"punctuation":"","begin_time":520,"fixed":true,"text":"使用"},{"end_time":1280,"punctuation":"","begin_time":880,"fixed":true,"text":"阿里"},{"end_time":1680,"punctuation":"。","begin_time":1280,"fixed":true,"text":"云"}],"begin_time":160,"text":"欢迎使用阿里云。","channel_id":0},"text":"欢迎使用阿里云。"},"usage":{"duration":2},"request_id":"372d19b3-993f-9288-adf0-a99f7606bd30"}
重要

百炼为新加坡地域推出了业务空间专属域名 https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com，能够为推理请求提供卓越的性能和更高的稳定性，建议从 https://dashscope-intl.aliyuncs.com 迁移至新域名。

其中 {WorkspaceId} 为您的业务空间 ID，可在百炼控制台的业务空间详情页面查看。现有域名仍可正常使用。

request_id string

本次请求的唯一标识。

output object

输出结果。

属性

text string

当前累积的完整识别文本。

sentence object

当前句子的详细信息。

属性

sentence_id integer

句子编号，从1开始。

sentence_end boolean

是否为该句的最终结果。为true时表示该句识别完成。

begin_time integer

句子开始时间，单位毫秒。

end_time integer

句子结束时间，单位毫秒。仅在sentence_end为true时返回。

text string

当前句子的识别文本。

channel_id integer

声道编号，从0开始。

words array

词级别时间戳列表。

属性

text string

词文本。

begin_time integer

词开始时间，单位毫秒。

end_time integer

词结束时间，单位毫秒。

punctuation string

词后的标点符号。无标点时为空字符串。

fixed boolean

词是否已稳定。false表示后续事件中该词的时间戳可能调整。

usage object

用量信息。仅在sentence_end为true时返回。

属性

duration integer

已处理的音频时长，单位秒。

SSE 流式结果处理逻辑

在流式模式下，客户端需关注以下处理要点：

  1. 每收到一个SSE事件，解析data字段中的JSON。

  2. 通过output.sentence.sentence_end判断当前句子是否结束：当该值为true时，该句识别完成，词级时间戳已稳定，可作为最终结果使用；当该值为false时，识别仍在进行中，文本和时间戳可能在后续事件中更新。

  3. usage信息仅在句子结束事件中返回，可用于计量音频处理时长。

上一篇：录音文件识别（Fun-ASR）下一篇：Python SDK