本文介紹 Qwen-Audio-ASR-Message 的用戶端事件及參數。
run-task
啟動語音辨識任務，設定模型、音頻格式、採樣率等參數。
發送時機：連線建立成功後立即發送。
響應事件：服務端返回 task-started 事件後才能發送音頻。
headerobject（必選）
屬性 action string（必選）指令類型，固定為 run-task。task_idstring（必選）用戶端產生的任務 ID（UUID 格式），用於關聯後續事件。streamingstring（必選）固定為 duplex。object（必選）
屬性 task_group string（必選）工作群組，固定為 audio。taskstring（必選）任務類型，固定為 asr。functionstring（必選）功能類型。固定為recognition。modelstring（必選）模型名稱。inputobject（必選）輸入對象。不攜帶上下文時傳入{}。
屬性 context array(object)（可選）對話上下文，用於輔助識別、提升專有詞彙的識別準確率。使用方法詳見上下文增強。
屬性 role string（必選）訊息角色。取值範圍：
array(object)（必選）訊息內容列表。
屬性 type string（必選）內容類型。取值範圍：
string（必選）常值內容。當 type 為 input_text 時，填入前幾輪使用者語音的識別結果或領域相關的詞表；當 type 為 text 時，填入前幾輪大語言模型的回複內容。object（必選）語音辨識參數。
屬性 keep_dialect boolean (可選)預設為 false，將方言轉寫為普通話文本。設為 true 時保留方言表達。僅在最終結果（sentence_end=true）生效，中間結果（sentence_end=false）不支援。vad_model string (可選)VAD 模型。取值為 near_meeting_16k（近場）或 far_field_meeting_16k（遠場，預設值）。disfluency_removal_enabled boolean (可選)是否過濾語氣詞並潤飾輸出。預設為 false，設為 true 時啟用。intermediate_result_enabled boolean (可選)是否傳回串流中間結果。預設為 false，設為 true 時傳回中間結果。formatstring（必選）音頻格式。取值範圍：
integer（必選）採樣率（Hz），僅支援 16000。vocabulary_idstring（可選）先行編譯熱詞列表 ID。需預先調用建立熱詞列表介面產生，識別時傳入該 ID 即可使用列表中的熱詞。適用於詞彙已知且相對穩定、需要跨請求複用同一詞表的情境。使用方法請參見先行編譯熱詞。vocabularyobject（可選）即時熱詞。以索引值對形式傳入，鍵為熱詞文本（string），值為熱詞權重（integer），無需預先建立熱詞列表。權重取值範圍為 [1, 5] 或 50：取 [1, 5] 時值越大模型越傾向輸出該詞；取 50 時為超級熱詞，召回率大幅提升，但超級熱詞數量最多不超過 50 個。適用於臨時性、會話層級的熱詞最佳化。與先行編譯熱詞同時配置時，僅即時熱詞生效。使用方法請參見即時熱詞。language_hintsarray[string]（可選）待識別音頻語種。無預設值，不設定時模型自動識別。最多支援設定 4 個值，超出時僅前 4 個生效。
點擊查看支援的語言代碼
sentence_end=true）生效，中間結果（sentence_end=false）不支援。max_sentence_silenceinteger（可選）VAD 斷句靜音閾值（毫秒）。語音後的靜音時長超過此值時判定句子結束。預設值為 800，取值範圍為 [200, 6000]。heartbeatboolean（可選）是否啟用心跳包。預設值：false。
float（可選）語音與噪音的判定閾值，用於調整語音活動檢測（VAD）的靈敏度。取值範圍：[-1.0, 1.0]。取值說明：
|
continue-task
在任務執行過程中更新對話上下文資訊，用於輔助識別。
發送時機：任務運行中，需要更新對話上下文時發送。
headerobject（必選）
屬性 action string（必選）指令類型，固定為 continue-task。task_idstring（必選）用戶端產生的任務 ID（UUID 格式），需與run-task事件中的 task_id 保持一致。streamingstring（必選）固定為 duplex。object（必選）
屬性 input object（必選）輸入對象。
屬性 context array(object)（可選）對話上下文，用於輔助識別、提升專有詞彙的識別準確率。使用方法詳見上下文增強。
屬性 role string（必選）訊息角色。取值範圍：
array(object)（必選）訊息內容列表。
屬性 type string（必選）內容類型。取值範圍：
string（必選）常值內容。當 type 為 input_text 時，填入前幾輪使用者語音的識別結果或領域相關的詞表；當 type 為 text 時，填入前幾輪大語言模型的回複內容。 |
finish-task
通知服務端音頻發送完畢，請求結束任務。
發送時機：所有音頻資料發送完畢後。
響應事件：服務端返回 task-finished 事件。
headerobject（必選）
屬性 action string（必選）指令類型，固定為 finish-task。task_idstring（必選）用戶端產生的任務 ID（UUID 格式），需與run-task事件中的 task_id 保持一致。streamingstring（必選）固定為 duplex。object（必選）
屬性 input object（必選）固定為{}。 |