Skip to main content

Qwen-Audio-ASR-Filetrans Node.js SDK

Gunakan SDK Node.js suara untuk mengirim URL audio ke Qwen-Audio-ASR-Filetrans, memeriksa tugas asinkron, dan mengunduh transkrip.

Instal SDK

Memerlukan Node.js 18 atau lebih baru. Unduh paket SDK 0.1.0, lalu jalankan perintah ini di proyek:
npm install ./dashscope-sdk-nodejs-0.1.0.tgz

Mulai cepat

Dapatkan API key di konsol dan atur sebagai variabel lingkungan DASHSCOPE_API_KEY. Simpan contoh berikut sebagai example.mjs dan jalankan node example.mjs.
import { TranscriptionClient } from 'dashscope-sdk-nodejs/asr'

const client = new TranscriptionClient({
  apiKey: process.env.DASHSCOPE_API_KEY,
  workspaceId: process.env.DASHSCOPE_WORKSPACE_ID,
  baseUrl: 'dashscope-intl.aliyuncs.com',
  model: 'qwen-audio-3.1-asr-flash-filetrans',
})
const job = await client.transcribe(
  'https://dashscope.oss-cn-beijing.aliyuncs.com/audios/welcome.mp3',
)
for (const result of job.results) {
  if (result.subtaskStatus === 'SUCCEEDED') {
    console.log('Transcript:', result.text)
  } else {
    console.error(result.code, result.message)
    process.exitCode = 1
  }
}

Referensi API

Opsi konstruktor

Opsi konstruktor TranscriptionClient:
ParameterTipeWajibDeskripsi
apiKeystringTidakAPI key. Default membaca DASHSCOPE_API_KEY.
workspaceIdstringTidakID ruang kerja. Default membaca DASHSCOPE_WORKSPACE_ID.
baseUrlstringTidakAtur nama host layanan ke dashscope-intl.aliyuncs.com (Singapura).
modelstringTidakID model. Default: qwen-audio-3.1-asr-flash-filetrans.
pollIntervalMsnumberTidakInterval polling. Default: 3000 ms.
pollTimeoutMsnumberTidakBatas waktu polling dalam ms. Default: 600000.
requestTimeoutMsnumberTidakBatas waktu permintaan HTTP dalam ms. Default: 30000; 0 menonaktifkan batas per permintaan.

Parameter transkripsi

Argumen kedua transcribe() dan submitTask() adalah parameters; argumen ketiga menerima context. Lihat HTTP API untuk detail parameter model.
ParameterTipeWajibDeskripsi
fileUrlsstring | string[]YaURL audio publik; satu file per tugas.
parameters.keep_dialectbooleanTidakPertahankan ekspresi dialek. Default: false.
parameters.vocabulary_idstringTidakID kosakata yang telah dikompilasi.
parameters.vocabularyRecord<string, number>TidakKosakata instan: kata sebagai kunci, bobot [1,5] atau 50 sebagai nilai.
parameters.channel_idnumber[]TidakIndeks kanal audio. Default: [0].
parameters.special_word_filterstring | Record<string, unknown>TidakKonfigurasi filter kata sensitif berupa string JSON atau objek.
parameters.diarization_enabledbooleanTidakDiarisasi pembicara untuk audio mono. Default: false.
parameters.speaker_countnumberTidakPerkiraan jumlah pembicara: [2,100]. Memerlukan diarisasi pembicara.
parameters.language_hintsstring[]TidakPetunjuk bahasa pengenalan. Maksimal 4 nilai pertama berlaku. Bahasa dideteksi otomatis jika diabaikan.
callOpts.context / submitOpts.contextAsrContextMessage[]TidakKonteks pengenalan. Format: { role, content: [{ type: "input_text", text }] }, dengan role berupa user atau assistant. Maksimal 5 pesan per peran, total kurang dari 400 karakter, berurutan sesuai giliran percakapan.
callOpts.onProgress(status: string, response: QueryTaskResponse) => voidTidakCallback progres polling dengan status dan response asli.

Metode utama

MetodeNilai kembalianDeskripsi
transcribe(fileUrls: string | string[], parameters?: TranscriptionParameters, callOpts?: TranscribeCallOptions)Promise<TranscriptionJobResult>Kirim audio, polling, lalu unduh hasil. callOpts menerima konteks dan callback progres.
submitTask(fileUrls: string | string[], parameters?: TranscriptionParameters, submitOpts?: TranscriptionSubmitOptions)Promise<{ taskId: string; taskStatus: string }>Kirim tugas dan kembalikan ID serta status awal. Atur konteks dengan submitOpts.context.
fetchTask(taskId: string, requestTimeoutMs?: number)Promise<QueryTaskResponse>Kueri tugas sekali untuk status dan URL hasil.

Nilai kembalian

KolomTipeDeskripsi
taskIdstringID tugas.
taskStatusstringStatus tugas.
resultsFileTranscriptionResult[]Hasil per file berisi subtaskStatus, text, transcription; item gagal memuat code dan message.
usageRecognitionUsage | undefinedPenggunaan yang dikembalikan layanan.
rawQueryTaskResponseRespons kueri tugas asli.