|
## Request body
model`string`(Required)
The model name.
input`object`(Required)
The input information.
messages`array(object)`(Required)
The message list. It contains the audio to recognize and, optionally, conversation context that improves recognition accuracy.
The context feature improves the recognition accuracy of domain-specific terms. For usage, see [Context enhancement](/en/model-studio/improve-asr-accuracy#ctx_enhance_h2).
A request can include at most 5 context messages of each type (`input_text` and `text`). If you exceed this limit, only the 5 most recent messages are kept. The total context text per turn (the combined length of the `text` fields in the `user` and `assistant` messages) cannot exceed 400 characters, where each character counts as 1. Any excess is truncated from the end.
When you include context, the message order in `messages` matters: context messages must be arranged by conversation turn. Within each turn, the `user` message (of type `input_text`) must come before the corresponding `assistant` message (of type `text`). The `user` message that contains `input_audio` must be the last item in the `messages` array.
role`string`(Required)
The message role. Valid values:
- `user` (Required): A user message. When type is `input_audio`, it holds the audio to recognize. When type is `input_text`, it holds recognition results from previous turns or a domain-specific word list (optional, used as context).
- `assistant` (Optional, context): Replies from the large language model in previous turns.
content`array(object)`(Required)
The message content list.
type`string`(Required)
The content type. Each request needs at least one message of type `input_audio`. Valid values:
- `input_audio` (Required): The audio input to recognize (role is user). You must also pass the `input_audio` object.
- `input_text` (Optional, context): Recognition results of the user's speech from previous turns, or a domain-specific word list (role is user). You must also pass the `text` field.
- `text` (Optional, context): Replies from the large language model in previous turns (role is assistant). You must also pass the `text` field.
input\_audio`object`(Conditionally required)
Required when `type` is `input_audio`.
data`string`(Required)
The audio data to recognize. For input requirements such as supported audio formats, file size limits, and duration limits, see [Audio specifications](/en/model-studio/asr-model#asr_audio_spec02). Two methods are supported:
- Audio file URL: Pass a publicly accessible URL to the audio file.
- Base64 Data URI: Pass the Base64-encoded audio data as a Data URI. The value is the `data:{MIME_TYPE};base64,` prefix concatenated with the Base64-encoded audio data. Supported MIME types include `audio/wav` and `audio/mp3`.
Example (URL): `https://example.com/audio/sample.wav`
Example (Base64): `data:audio/wav;base64,{BASE64_ENCODED_DATA}`
text`string`(Conditionally required)
When `type` is `input_text`, enter the recognition results of the user's speech from previous turns or a domain-specific word list. When `type` is `text`, enter the large language model's replies from previous turns. Text length is measured in characters, where each character counts as 1. The combined length of the `text` fields across all messages in a single context turn cannot exceed 400 characters. Any excess is truncated from the end.
parameters`object`(Required)
The model parameters.
Text polishing is disabled by default and is not yet available.
Text polishing: While transcribing speech, the model removes meaningless filler words and stuttered repetitions, handles self-corrections, smooths out colloquial expressions, and standardizes punctuation and text formatting. The output is more concise, fluent, and readable while preserving the speaker’s final intent and key information as much as possible.
format`string`(Required)
The audio format. Set this to match your actual audio format. Supported values include `wav`, `mp3`, and `opus`. For details, see [Audio specifications](/en/model-studio/asr-model#asr_audio_spec02).
sample\_rate`string`(Optional)
The audio sample rate, in Hz. For example, `16000` means a 16 kHz sample rate. For details, see [Audio specifications](/en/model-studio/asr-model#asr_audio_spec02).
vocabulary\_id`string`(Optional)
The ID of a precompiled hot word list.
Generate this ID in advance by calling the create hot word list API. Pass the ID during recognition to use the hot words in the list.
Suitable for scenarios where the vocabulary is known and relatively stable, and where you need to reuse the same word list across requests.
For usage details, see [Precompiled hotwords](/en/model-studio/improve-asr-accuracy#hw_precompiled_h3).
language\_hints `array[string]`(Optional)
The language codes to recognize. If the language is unknown in advance, omit this parameter to let the model detect it automatically. You can set up to 1 value. If you set more, only the first 1 take effect.
- zh: Chinese
- en: English
- ja: Japanese
- ko: Korean
- vi: Vietnamese
- th: Thai
- id: Indonesian
- ms: Malay
- tl: Filipino
- hi: Hindi
- ar: Arabic
- fr: French
- de: German
- es: Spanish
- pt: Portuguese
- ru: Russian
- it: Italian
- nl: Dutch
- sv: Swedish
- da: Danish
- fi: Finnish
- no: Norwegian
- el: Greek
- pl: Polish
- cs: Czech
- hu: Hungarian
- ro: Romanian
- bg: Bulgarian
- hr: Croatian
- sk: Slovak
|
The following examples use the configuration for the Singapore region. Replace "\{WorkspaceId}" with your actual workspace ID. The configuration differs across regions, and the API key for the Singapore region differs from the one for the Beijing region.
```bash expandable
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": "{YOUR_AUDIO_URL}"
}
}
]
}
]
},
"parameters": {
"format": "wav",
"sample_rate": "16000"
}
}'
```
```bash expandable
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": "{YOUR_AUDIO_URL}"
}
}
]
}
]
},
"parameters": {
"format": "wav",
"sample_rate": "16000"
}
}'
```
```bash expandable
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 @- <<'JSON'
{
"model": "fun-asr-flash-2026-06-15",
"input": {
"messages": [
{
"role": "user",
"content": [
{
"type": "input_text",
"text": "Hello"
}
]
},
{
"role": "assistant",
"content": [
{
"type": "text",
"text": "Hello, I'm Qwen. How can I help you?"
}
]
},
{
"role": "user",
"content": [
{
"type": "input_audio",
"input_audio": {
"data": "{YOUR_AUDIO_URL}"
}
}
]
}
]
},
"parameters": {
"format": "wav",
"sample_rate": "16000"
}
}
JSON
```
```bash expandable
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 @- <<'JSON'
{
"model": "fun-asr-flash-2026-06-15",
"input": {
"messages": [
{
"role": "user",
"content": [
{
"type": "input_text",
"text": "Hello"
}
]
},
{
"role": "assistant",
"content": [
{
"type": "text",
"text": "Hello, I'm Qwen. How can I help you?"
}
]
},
{
"role": "user",
"content": [
{
"type": "input_audio",
"input_audio": {
"data": "{YOUR_AUDIO_URL}"
}
}
]
}
]
},
"parameters": {
"format": "wav",
"sample_rate": "16000"
}
}
JSON
```
You can pass Base64-encoded data ([Data URL](https://www.rfc-editor.org/rfc/rfc2397)) in the format `data:;base64,`.
- ``: The MIME type.
The value depends on the audio format. For example:
- WAV: `audio/wav`
- MP3: `audio/mpeg`
- ``: The Base64-encoded string of the audio.
Base64 encoding increases the data size. For audio file size and duration limits, see [Audio specifications](/en/model-studio/asr-model#asr_audio_spec02).
- Example: `data:audio/wav;base64,SUQzBAAAAAAAI1RTU0UAAAAPAAADTGF2ZjU4LjI5LjEwMAAAAAAAAAAAAAAA//PAxABQ/BXRbMPe4IQAhl9`
```python
import base64, pathlib
# Replace with the path to your own audio file and make sure it meets the audio requirements
file_path = pathlib.Path("{YOUR_AUDIO_FILE}")
base64_str = base64.b64encode(file_path.read_bytes()).decode()
data_uri = f"data:audio/mpeg;base64,{base64_str}"
```
```java expandable
import java.nio.file.*;
import java.util.Base64;
public class Main {
/**
* Replace with the path to your own audio file and make sure it meets the audio requirements
*/
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("{YOUR_AUDIO_FILE}"));
}
}
```
```python expandable
import base64, pathlib
import os
import requests
# Replace with the path to your own audio file and make sure it meets the audio requirements
file_path = pathlib.Path("{YOUR_AUDIO_FILE}")
base64_str = base64.b64encode(file_path.read_bytes()).decode()
data_uri = f"data:audio/wav;base64,{base64_str}"
# Replace "{WorkspaceId}" with your actual workspace 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())
```
|