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:
Mulai cepat
Simpan contoh berikut sebagai example.mjs dan jalankan node example.mjs.
Parameter permintaan
Opsi konstruktor SpeechSynthesizer:
| Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
apiKey | string | Tidak | API key. Default membaca DASHSCOPE_API_KEY. |
workspaceId | string | Tidak | ID ruang kerja. Default membaca DASHSCOPE_WORKSPACE_ID. |
baseUrl | string | Tidak | Atur nama host layanan ke dashscope-intl.aliyuncs.com (Singapura). |
model | string | Tidak | ID model. Default: qwen-audio-3.1-tts-flash. |
voice | string | Ya | ID suara. Pilih suara yang kompatibel dengan model. |
format | 'pcm' | 'wav' | 'mp3' | 'opus' | Tidak | Encoding audio. Menggunakan default layanan jika diabaikan. |
sampleRate | 8000 | 16000 | 22050 | 24000 | 44100 | 48000 | Tidak | Laju sampel audio dalam Hz. Harus sesuai encoding; layanan menentukan nilainya jika diabaikan. |
volume | number | Tidak | Volume: [0,100]. Default layanan: 50. |
rate | number | Tidak | Kecepatan bicara: [0.5,2.0]. Default layanan: 1.0. |
pitch | number | Tidak | Nada: [0.5,2.0]. Default layanan: 1.0. |
wordTimestampEnabled | boolean | Tidak | Kembalikan stempel waktu kata. Default: false. |
languageHints | string[] | 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. |
instruction | string | Tidak | Instruksi sintesis untuk dialek, emosi, atau peran. |
parameters | TtsSynthesisParameters | Tidak | Parameter sintesis tambahan, seperti enable_ssml, seed, dan hot_fix. |
connectTimeoutMs | number | Tidak | Batas waktu koneksi dalam ms. Default: 10000. |
taskTimeoutMs | number | Tidak | Batas waktu konfirmasi mulai/selesai dalam ms. Default: 60000; 0 menonaktifkannya. |
parameters.enable_ssml | boolean | Tidak | Aktifkan SSML. Kirim teks SSML lengkap yang tidak kosong sekali per tugas. Lihat batasan. |
parameters.bit_rate | number | Tidak | Bit rate MP3/Opus dalam kbps. Rentang: [6,510]; default: 32. |
parameters.seed | number | Tidak | Seed acak: [0,65535]. |
parameters.hot_fix | Record<string, unknown> | Tidak | Konfigurasi hot-fix melalui parameters.hot_fix. Lihat strukturnya pada peristiwa klien. |
Referensi API
Metode utama
| Metode | Nilai kembalian | Deskripsi |
|---|---|---|
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) | void | Kirim potongan teks: maksimal 20000 karakter per panggilan dan 200000 per tugas. |
end() | Promise<Buffer> | Akhiri input teks, tunggu sintesis, lalu kembalikan audio lengkap. |
cancel() | void | Minta pembatalan sintesis. |
close(code?: number, reason?: string) | void | Tutup koneksi dan lepaskan sumber daya tugas. |
Peristiwa callback
Daftarkan callback dengan on(event, listener). Lihat peristiwa server untuk kolom lengkap.
| Peristiwa | Payload | Deskripsi |
|---|---|---|
started | { taskId: string } | Tugas sudah dimulai dan menerima input. |
audio | Buffer | Potongan 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 / error | DashScopeError | Kesalahan pemanggilan dengan code, message, dan identitas permintaan. |
close | { code: number; reason: string } | Notifikasi penutupan koneksi dasar. |
event | ServerEvent | Pesan JSON layanan asli. |