即時語音辨識（Qwen-ASR-Realtime）Java SDK-API參考

​

前提條件

1. 安裝SDK，確保DashScope SDK版本不低於2.22.5。
2. 擷取API Key。
3. 瞭解WebSocket API。

​

請求參數

• 以下參數通過OmniRealtimeParam的鏈式方法設定。
  點擊查看範例程式碼

  Copy

  OmniRealtimeParam param = OmniRealtimeParam.builder()
                  .model("qwen3-asr-flash-realtime")
                  // 以下為新加坡地區的配置，調用時請將"{WorkspaceId}"替換為真實的業務空間ID，各地區的配置不同。
                  .url("wss://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api-ws/v1/realtime")
                  // 新加坡和北京地區的API Key不同。擷取API Key：https://www.alibabacloud.com/help/zh/model-studio/get-api-key
                  // 若沒有配置環境變數，請用百鍊API Key將下行替換為：.apikey("sk-xxx")
                  .apikey(System.getenv("DASHSCOPE_API_KEY"))
                  .build();
  

  參數	類型	是否必須	說明
  model	String	是	指定要使用的模型名稱。
  url	String	是	語音辨識服務地址： 華北2（北京）地區：wss://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api-ws/v1/realtime。調用時請將{WorkspaceId}替換為真實的Workspace ID。 新加坡地區：wss://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api-ws/v1/realtime。調用時請將{WorkspaceId}替換為真實的業務空間ID。
  apikey	String	否	設定API Key。

• 以下參數通過OmniRealtimeConfig的鏈式方法設定。
  點擊查看範例程式碼

  Copy

  OmniRealtimeTranscriptionParam transcriptionParam = new OmniRealtimeTranscriptionParam();
          transcriptionParam.setLanguage("zh");
          transcriptionParam.setInputSampleRate(16000);
          transcriptionParam.setInputAudioFormat("pcm");
  
  OmniRealtimeConfig config = OmniRealtimeConfig.builder()
                  .modalities(Collections.singletonList(OmniRealtimeModality.TEXT))
                  .enableTurnDetection( true)
                  .turnDetectionType("server_vad")
                  .turnDetectionThreshold(0.0f)
                  .turnDetectionSilenceDurationMs(400)
                  .transcriptionConfig(transcriptionParam)
                  .build();
  

  參數	類型	是否必須	說明
  modalities	List<OmniRealtimeModality>	是	模型輸出模態，固定為[OmniRealtimeModality.TEXT]。
  enableTurnDetection	boolean	否	是否開啟服務端語音活動檢測（VAD）。關閉後，需手動調用commit()方法觸發識別。 預設值：true。 取值範圍： true：開啟 false：關閉
  turnDetectionType	String	否	服務端VAD類型，固定為 server_vad。
  turnDetectionThreshold	float	否	VAD檢測閾值。推薦將該值設為0.0。 預設值：0.2。 取值範圍：[-1, 1]。 較低的閾值會提高 VAD 的靈敏度，可能將背景雜音誤判為語音。較高的閾值則降低靈敏度，有助於在嘈雜環境中減少誤觸發。
  turnDetectionSilenceDurationMs	int	否	VAD斷句檢測閾值（ms）。靜音持續時間長度超過該閾值將被認為是語句結束。推薦將該值設為400。 預設值：800。 取值範圍：[200, 6000]。 較低的值（如 300ms）可使模型更快響應，但可能導致在自然停頓處發生不合理的斷句。較高的值（如 1200ms）可更好地處理長句內的停頓，但會增加整體響應延遲。
  transcriptionConfig	OmniRealtimeTranscriptionParam	否	語音辨識相關配置。

• 以下參數通過OmniRealtimeTranscriptionParam的setter方法設定。
  點擊查看範例程式碼

  Copy

  OmniRealtimeTranscriptionParam transcriptionParam = new OmniRealtimeTranscriptionParam();
          transcriptionParam.setLanguage("zh");
          transcriptionParam.setInputSampleRate(16000);
          transcriptionParam.setInputAudioFormat("pcm");
  

  參數	類型	是否必須	說明
  language	String	否	音頻源語言。 zh：中文（普通話、四川話、閩南語、吳語） yue：粵語 en：英文 ja：日語 de：德語 ko：韓語 ru：俄語 fr：法語 pt：葡萄牙語 ar：阿拉伯語 it：意大利語 es：西班牙語 hi：印地語 id：印尼語 th：泰語 tr：土耳其語 uk：烏克蘭語 vi：越南語 cs：捷克語 da：丹麥語 fil：菲律賓語 fi：芬蘭語 is：冰島語 ms：馬來語 no：挪威語 pl：波蘭語 sv：瑞典語
  inputSampleRate	int	否	音頻採樣率（Hz）。支援16000和8000。 預設值：16000。 設定為 8000 時，服務端會先升採樣到16000Hz再進行識別，可能引入微小延遲。建議僅在源音頻為8000Hz（如電話線路）時使用。
  inputAudioFormat	String	否	音頻格式。支援pcm和opus。 預設值：pcm。

​

關鍵介面

​

OmniRealtimeConversation類

public OmniRealtimeConversation(OmniRealtimeParam param, OmniRealtimeCallback callback)

public void connect() throws NoApiKeyException, InterruptedException

public void updateSession(OmniRealtimeConfig config)

public void appendAudio(String audioBase64)

public void commit()

public void endSession() throws InterruptedException

public void close()

public String getSessionId()

public String getResponseId()

​

回調介面（OmniRealtimeCallback）

public void onOpen()

public abstract void onEvent(JsonObject message)

public abstract void onClose(int code, String reason)