|
header object (Required)
Properties
action string (Required)
The command type. Set to run-task.
task_id string (Required)
A client-generated task ID (UUID format) that links subsequent events to this task.
streaming string (Required)
|
Basic request{
"header": {
"action": "run-task",
"task_id": "2bf83b9a-baeb-4fda-8d9a-xxxxxxxxxxxx",
"streaming": "duplex"
},
"payload": {
"task_group": "audio",
"task": "asr",
"function": "recognition",
"model": "qwen-audio-3.0-asr-flash-streaming",
"parameters": {
"format": "pcm",
"sample_rate": 16000
},
"input": {}
}
}
With context{
"header": {
"action": "run-task",
"task_id": "2bf83b9a-baeb-4fda-8d9a-xxxxxxxxxxxx",
"streaming": "duplex"
},
"payload": {
"task_group": "audio",
"task": "asr",
"function": "recognition",
"model": "qwen-audio-3.0-asr-flash-streaming",
"parameters": {
"format": "pcm",
"sample_rate": 16000
},
"input": {
"context": [
{
"role": "user",
"content": [
{
"type": "input_text",
"text": "Hello there"
}
]
},
{
"role": "assistant",
"content": [
{
"type": "text",
"text": "Hello, I am Qwen. How can I help you?"
}
]
}
]
}
}
}
Instant hot words{
"header": {
"action": "run-task",
"task_id": "2bf83b9a-baeb-4fda-8d9a-xxxxxxxxxxxx",
"streaming": "duplex"
},
"payload": {
"task_group": "audio",
"task": "asr",
"function": "recognition",
"model": "qwen-audio-3.0-asr-flash-streaming",
"parameters": {
"format": "pcm",
"sample_rate": 16000,
"vocabulary": {"John Smith": 5, "Jane Doe": 5}
},
"input": {}
}
}
|
|
payload object (Required)
Properties
task_group string (Required)
The task group. Set to audio.
task string (Required)
The task type. Set to asr.
function string (Required)
The function type. Set to recognition.
model string (Required)
The model name. The Qwen-Audio-3.0-ASR-Flash-Streaming and Fun-ASR-Realtime model series are supported. For details, see Supported models and regions.
input object (Required)
The input object. Pass {} when no context is provided.
Important
Only the qwen-audio-3.0-asr-flash-streaming, fun-asr-realtime, and fun-asr-realtime-2025-11-07 models support context.
parameters object (Required)
The speech recognition parameters.
Properties
format string (Required)
The audio format.
Valid values:
-
pcm
-
wav
-
mp3
-
opus
-
speex
-
aac
-
amr
Important
opus/speex: Must use Ogg encapsulation.
wav: Must use PCM encoding.
amr: Only the AMR-NB type is supported.
sample_rate integer (Required)
The sample rate, in Hz.
Valid values: 8 kHz models support only 8000 Hz; other models support any sample rate.
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.
vocabulary object (Optional)
Instant hot words.
Passed as key-value pairs, where the key is the hot word text (string) and the value is the hot word weight (integer). No hot word list needs to be created in advance. The weight ranges from [1, 5] or is set to 50: a value in [1, 5] makes the model more likely to output the word as the value increases; a value of 50 designates a super hot word, which greatly improves recall, but the number of super hot words cannot exceed 50.
Suitable for temporary, session-level hot word optimization.
When configured together with precompiled hot words, only the instant hot words take effect. For usage details, see Instant hotwords.
Important
Only qwen-audio-3.0-asr-flash-streaming supports instant hot words.
language_hints array[string] (Optional)
The language of the audio to recognize. There is no default value; if not set, the model detects the language automatically.
For the Qwen-Audio-3.0-ASR-Flash-Streaming model series, you can set up to 4 values; if you set more than 4, only the first 4 take effect. For the Fun-ASR-Realtime model series, you can set only 1 value; if you set multiple values, only the first one takes effect.
Click to view the supported language codes
-
qwen-audio-3.0-asr-flash-streaming, fun-asr-realtime, fun-asr-realtime-2025-11-07:
-
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
-
fun-asr-realtime-2026-02-28:
-
zh: Chinese
-
en: English
-
ja: Japanese
-
fun-asr-realtime-2025-09-15:
-
fun-asr-flash-8k-realtime, fun-asr-flash-8k-realtime-2026-01-28:
semantic_punctuation_enabled boolean (Optional)
Whether to enable semantic segmentation.
Default value: false.
Semantic segmentation is more accurate and is better suited to meeting transcription scenarios. VAD (Voice Activity Detection) segmentation has lower latency and is better suited to interactive scenarios.
max_sentence_silence integer (Optional)
The VAD silence threshold for segmentation, in ms. When the silence after a segment of speech exceeds this threshold, the system determines that the sentence has ended. When semantic_punctuation_enabled is set to true, this parameter is not used as the criterion for returning sentence_end, but setting it too low may affect recognition performance.
Default value: 1300.
Valid values: [200, 6000].
multi_threshold_mode_enabled boolean (Optional)
Important
Takes effect only when semantic_punctuation_enabled is false.
Whether to enable multi-threshold mode. When enabled, this prevents VAD segments from becoming too long.
Default value: false.
heartbeat boolean (Optional)
Whether to enable heartbeat packets.
Default value: false.
-
true: Keeps the connection to the server alive even when silent audio is sent continuously.
-
false (default): The connection is disconnected due to timeout after 60 seconds, even if silent audio is sent continuously.
Silent audio refers to content in an audio file or data stream that contains no sound signal. You can generate silent audio in several ways, such as using audio editing software like Audacity or Adobe Audition, or using a command-line tool like FFmpeg.
speech_noise_threshold float (Optional)
The threshold for distinguishing speech from noise, used to adjust the sensitivity of Voice Activity Detection (VAD).
Valid values: [-1.0, 1.0].
Value descriptions:
-
The closer the value is to -1: The noise threshold decreases, so noise is more likely to be recognized as speech, which may cause more noise to be transcribed.
-
The closer the value is to +1: The noise threshold increases, so speech is more likely to be misjudged as noise, which may cause some speech to be filtered out.
This is an advanced configuration parameter. Adjusting it can significantly affect recognition results. Recommendations:
special_word_filter string (Optional)
Specifies the sensitive words to process during speech recognition, and supports setting different processing methods for different sensitive words. For details, see Sensitive word filtering.
|