Skip to main content

Qwen-Audio-TTS Node.js SDK

Gunakan SDK Node.js suara untuk memanggil Qwen-Audio-TTS dengan teks lengkap atau streaming, serta menangani audio, stempel waktu kata, dan penggunaan.

Prasyarat

Dapatkan API key di konsol dan atur sebagai variabel lingkungan DASHSCOPE_API_KEY.

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

Simpan contoh berikut sebagai example.mjs dan jalankan node example.mjs.
import { writeFile } from 'node:fs/promises'
import { SpeechSynthesizer } from 'dashscope-sdk-nodejs/tts'

const synth = new SpeechSynthesizer({
  apiKey: process.env.DASHSCOPE_API_KEY,
  workspaceId: process.env.DASHSCOPE_WORKSPACE_ID,
  baseUrl: 'dashscope-intl.aliyuncs.com',
  model: 'qwen-audio-3.1-tts-flash',
  voice: 'longanhuan_v3.1',
  format: 'mp3',
  sampleRate: 24000,
})
synth.on('error', err => console.error(err.code, err.message))

try {
  const audio = await synth.synthesize('Hello, welcome to Qwen Audio.')
  await writeFile('output.mp3', audio)
} finally {
  synth.close()
}

Parameter permintaan

Opsi konstruktor SpeechSynthesizer:
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-tts-flash.
voicestringYaID suara. Pilih suara yang kompatibel dengan model.
format'pcm' | 'wav' | 'mp3' | 'opus'TidakEncoding audio. Menggunakan default layanan jika diabaikan.
sampleRate8000 | 16000 | 22050 | 24000 | 44100 | 48000TidakLaju sampel audio dalam Hz. Harus sesuai encoding; layanan menentukan nilainya jika diabaikan.
volumenumberTidakVolume: [0,100]. Default layanan: 50.
ratenumberTidakKecepatan bicara: [0.5,2.0]. Default layanan: 1.0.
pitchnumberTidakNada: [0.5,2.0]. Default layanan: 1.0.
wordTimestampEnabledbooleanTidakKembalikan stempel waktu kata. Default: false.
languageHintsstring[]Tidak
Untuk suara multibahasa dan dialek pada qwen-audio-3.1-tts-flash, parameter ini menentukan bahasa atau dialek. Lihat pengaturan suara multibahasa dan dialek untuk detailnya.
Petunjuk bahasa target. Hanya elemen pertama yang berlaku.
instructionstringTidakInstruksi sintesis untuk dialek, emosi, atau peran.
parametersTtsSynthesisParametersTidakParameter sintesis tambahan, seperti enable_ssml, seed, dan hot_fix.
connectTimeoutMsnumberTidakBatas waktu koneksi dalam ms. Default: 10000.
taskTimeoutMsnumberTidakBatas waktu konfirmasi mulai/selesai dalam ms. Default: 60000; 0 menonaktifkannya.
parameters.enable_ssmlbooleanTidakAktifkan SSML. Kirim teks SSML lengkap yang tidak kosong sekali per tugas. Lihat batasan.
parameters.bit_ratenumberTidakBit rate MP3/Opus dalam kbps. Rentang: [6,510]; default: 32.
parameters.seednumberTidakSeed acak: [0,65535].
parameters.hot_fixRecord<string, unknown>TidakKonfigurasi hot-fix melalui parameters.hot_fix. Lihat strukturnya pada peristiwa klien.

Referensi API

Metode utama

MetodeNilai kembalianDeskripsi
synthesize(text: string)Promise<Buffer>Sintesis teks lengkap dan kembalikan audio. Maksimal 20000 karakter.
begin()Promise<void>Mulai tugas sintesis streaming, lalu kirim teks.
sendText(text: string)voidKirim potongan teks: maksimal 20000 karakter per panggilan dan 200000 per tugas.
end()Promise<Buffer>Akhiri input teks, tunggu sintesis, lalu kembalikan audio lengkap.
cancel()voidMinta pembatalan sintesis.
close(code?: number, reason?: string)voidTutup koneksi dan lepaskan sumber daya tugas.

Peristiwa callback

Daftarkan callback dengan on(event, listener). Lihat peristiwa server untuk kolom lengkap.
PeristiwaPayloadDeskripsi
started{ taskId: string }Tugas sudah dimulai dan menerima input.
audioBufferPotongan audio biner; dapat dipicu beberapa kali.
sentenceBegin{ index: number; text: string }Sintesis kalimat dimulai.
sentenceEnd{ index: number; text: string; characters?: number; words?: TtsWord[]; usage?: TtsUsage }Sintesis kalimat selesai; dapat memuat stempel waktu kata dan penggunaan asli.
finished{ taskId: string; characters?: number; usage?: TtsUsage }Tugas selesai dan status lokal dibersihkan.
failed / errorDashScopeErrorKesalahan pemanggilan dengan code, message, dan identitas permintaan.
close{ code: number; reason: string }Notifikasi penutupan koneksi dasar.
eventServerEventPesan JSON layanan asli.