全部产品
Search

搜索本产品

    大模型服务平台百炼：Fun-ASR录音文件识别HTTP API参考

    文档中心

    大模型服务平台百炼：Fun-ASR录音文件识别HTTP API参考

    更新时间：Jul 02, 2026

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

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

    DashScope异步调用（Fun-ASR）

    流程说明

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

    1. 第一步：提交任务

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

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

    2. 第二步：获取结果

      • 客户端使用获取到的 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。

    华北2（北京）

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

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

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

    重要

    阿里云百炼为华北2（北京）、新加坡地域推出了业务空间专属域名，能够为推理请求提供卓越的性能和更高的稳定性，建议迁移至新域名：

    • 华北2（北京）地域：从 dashscope.aliyuncs.com 迁移至 {WorkspaceId}.cn-beijing.maas.aliyuncs.com

    • 新加坡地域：从 dashscope-intl.aliyuncs.com 迁移至 {WorkspaceId}.ap-southeast-1.maas.aliyuncs.com

    {WorkspaceId}需要替换为真实的Workspace 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，请勿遗漏，否则无法提交任务。

    提交任务接口

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

    请求体

    以下为新加坡地域的配置，调用时请将"{WorkspaceId}"替换为真实的业务空间ID，各地域的配置不同。新加坡地域和北京地域的API Key不同。

    curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.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。

    查询任务接口

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

    请求体

    以下为新加坡地域的配置，调用时请将"{WorkspaceId}"替换为真实的业务空间ID，各地域的配置不同。新加坡地域和北京地域的API Key不同。

    curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.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": "FILE_DOWNLOAD_FAILED",
            "message": "FILE_DOWNLOAD_FAILED",
            "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调用。

    服务端点

    新加坡

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

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

    华北2（北京）

    POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation

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

    重要

    阿里云百炼为华北2（北京）、新加坡地域推出了业务空间专属域名，能够为推理请求提供卓越的性能和更高的稳定性，建议迁移至新域名：

    • 华北2（北京）地域：从 dashscope.aliyuncs.com 迁移至 {WorkspaceId}.cn-beijing.maas.aliyuncs.com

    • 新加坡地域：从 dashscope-intl.aliyuncs.com 迁移至 {WorkspaceId}.ap-southeast-1.maas.aliyuncs.com

    {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或不传该参数则仅返回最终结果。

    请求体

    以下为新加坡地域的配置，调用时请将"{WorkspaceId}"替换为真实的业务空间ID，各地域的配置不同。新加坡地域和北京地域的API Key不同。

    非流式

    curl --location --request POST 'https://{WorkspaceId}.ap-southeast-1.maas.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://{WorkspaceId}.ap-southeast-1.maas.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://{WorkspaceId}.ap-southeast-1.maas.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_text",
                        "text": "你好啊"
                    }
                ]
            },
            {
                "role": "assistant",
                "content": [
                    {
                        "type": "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://{WorkspaceId}.ap-southeast-1.maas.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_text",
                        "text": "你好啊"
                    }
                ]
            },
            {
                "role": "assistant",
                "content": [
                    {
                        "type": "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}"

# 请将"{WorkspaceId}"替换为真实的业务空间ID
url = "https://{WorkspaceId}.ap-southeast-1.maas.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) （必选）

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

    重要

    上下文功能用于提升专有词汇的识别准确率，使用方法详见快速开始。约束：上下文消息（input_text 和 text 类型）各最多 5 条，超出时保留最近的 5 条。每轮上下文文本总长度（user 和 assistant 的 text 字段长度之和）不超过 400 个字符（按字符数计算，每个字符计为 1），超出部分从末尾截断。

    重要

    携带上下文时，messages 中的消息顺序有要求：上下文消息必须按对话轮次排列，每轮中 user（input_text 类型）必须在对应的 assistant（text 类型）之前；包含 input_audio 的 user 消息必须放在 messages 数组的最后。

    属性

    role string （必选）

    消息角色。取值范围：

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

    • assistant（可选，上下文）：前几轮大语言模型的回复内容。

    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时，填入前几轮大语言模型的回复内容。文本按字符数计算，每个字符计为 1。每轮上下文中所有消息的 text 字段长度之和不超过 400 个字符，超出部分从末尾截断。

    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信息仅在句子结束事件中返回，可用于计量音频处理时长。