通過語音 Node.js SDK 調用 Qwen-Audio-ASR-Filetrans,提交錄音文件 URL、查詢異步任務並下載轉寫結果。
安裝 SDK
需要 Node.js 18 或以上版本。下載 SDK 0.1.0 安裝包後,在項目目錄運行:
快速開始
在控制台獲取 API Key,並配置為環境變量 DASHSCOPE_API_KEY。
將以下示例保存為 example.mjs,運行 node example.mjs。
接口參考
構造參數
TranscriptionClient 的構造參數如下。
| 參數 | 類型 | 必填 | 說明 |
|---|---|---|---|
apiKey | string | 否 | API Key。默認讀取 DASHSCOPE_API_KEY。 |
workspaceId | string | 否 | 業務空間 ID。默認讀取 DASHSCOPE_WORKSPACE_ID。 |
baseUrl | string | 否 | 服務域名,設置為 dashscope-intl.aliyuncs.com(新加坡)。 |
model | string | 否 | 模型 ID,默認 qwen-audio-3.1-asr-flash-filetrans。 |
pollIntervalMs | number | 否 | 查詢間隔,默認 3000 ms。 |
pollTimeoutMs | number | 否 | 輪詢超時(ms),默認 600000。 |
requestTimeoutMs | number | 否 | 單次 HTTP 請求超時(ms),默認 30000;0 表示不限制單次請求。 |
轉寫參數
transcribe() 和 submitTask() 的第二個參數為 parameters,第三個參數可傳入 context。模型參數的完整說明見 HTTP API。
| 參數 | 類型 | 必填 | 說明 |
|---|---|---|---|
fileUrls | string | string[] | 是 | 公網可訪問的音頻 URL;每次提交一個文件。 |
parameters.keep_dialect | boolean | 否 | 保留方言表達,默認 false。 |
parameters.vocabulary_id | string | 否 | 預編譯熱詞列表 ID。 |
parameters.vocabulary | Record<string, number> | 否 | 即時熱詞:鍵為詞,值為權重 [1,5] 或 50。 |
parameters.channel_id | number[] | 否 | 音軌索引,默認 [0]。 |
parameters.special_word_filter | string | Record<string, unknown> | 否 | 敏感詞過濾配置,可傳 JSON 字符串或對象。 |
parameters.diarization_enabled | boolean | 否 | 單聲道音頻的說話人分離,默認 false。 |
parameters.speaker_count | number | 否 | 說話人數量參考值,範圍 [2,100],需啓用說話人分離。 |
parameters.language_hints | string[] | 否 | 識別語言提示,最多使用前 4 個值;未設置時自動識別。 |
callOpts.context / submitOpts.context | AsrContextMessage[] | 否 | 識別上下文。消息格式為 { role, content: [{ type: "input_text", text }] },role 為 user 或 assistant;每種角色最多 5 條,文本共少於 400 字符,按對話輪次排列。 |
callOpts.onProgress | (status: string, response: QueryTaskResponse) => void | 否 | 查詢進度回調,接收 status 和原始響應 response。 |
主要方法
| 方法 | 返回值 | 說明 |
|---|---|---|
transcribe(fileUrls: string | string[], parameters?: TranscriptionParameters, callOpts?: TranscribeCallOptions) | Promise<TranscriptionJobResult> | 提交音頻、輪詢並下載結果;callOpts 可設置上下文和進度回調。 |
submitTask(fileUrls: string | string[], parameters?: TranscriptionParameters, submitOpts?: TranscriptionSubmitOptions) | Promise<{ taskId: string; taskStatus: string }> | 提交任務並返回任務 ID、初始狀態;submitOpts.context 設置識別上下文。 |
fetchTask(taskId: string, requestTimeoutMs?: number) | Promise<QueryTaskResponse> | 查詢一次任務,返回狀態和結果下載鏈接。 |
返回結果
| 字段 | 類型 | 說明 |
|---|---|---|
taskId | string | 任務 ID。 |
taskStatus | string | 任務狀態。 |
results | FileTranscriptionResult[] | 文件結果列表,包含 subtaskStatus、text、transcription;失敗項含 code、message。 |
usage | RecognitionUsage | undefined | 服務端返回的用量統計。 |
raw | QueryTaskResponse | 原始任務查詢響應。 |