Topik ini menjelaskan antarmuka utama dan parameter permintaan untuk memanggil model seri Qwen-TTS-Realtime menggunakan DashScope Java SDK.
Prasyarat
Diperlukan DashScope Java SDK versi 2.22.7 atau lebih baru.
Mulai cepat
Parameter permintaan
Konfigurasikan parameter permintaan berikut menggunakan metode chaining atau setter dari objek QwenTtsRealtimeParam, lalu teruskan objek tersebut ke konstruktor QwenTtsRealtime.
Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
model | String | Ya | Nama model (lihat Model yang didukung). |
url | String | Ya | China (Beijing): Singapura: |
QwenTtsRealtimeConfig, lalu teruskan objek tersebut ke metode updateSession.
Parameter | Type | Wajib | Deskripsi |
|---|---|---|---|
voice | String | Ya | Voice untuk sintesis suara. Untuk informasi selengkapnya, lihat Daftar voice Qwen-TTS. |
languageType | String | Tidak | Menentukan bahasa audio hasil sintesis. Nilai default adalah
|
mode | String | Tidak | Mode interaksi. Nilai yang valid:
|
format | String | Tidak | Format output audio dari model. Format yang didukung:
|
sampleRate | int | Tidak | Laju sampel output audio dari model, dalam Hz. Laju sampel yang didukung:
|
speechRate | float | Tidak | Kecepatan bicara audio. Nilai 1.0 adalah kecepatan normal. Nilai kurang dari 1.0 lebih lambat, dan nilai lebih dari 1.0 lebih cepat. Nilai default: 1.0. Rentang valid: [0.5, 2.0]. |
volume | int | Tidak | Volume audio. Rentang valid: [0, 100]. |
pitchRate | float | Tidak | Nada audio hasil sintesis. Nilai default: 1.0. Rentang valid: [0.5, 2.0]. |
bitRate | int | Tidak | Menentukan bitrate audio dalam kbps. Bitrate yang lebih tinggi menghasilkan kualitas audio lebih baik dan ukuran file lebih besar. Parameter ini hanya tersedia ketika format audio ( Nilai default: 128. Rentang valid: [6, 510]. |
Referensi API
Kelas QwenTtsRealtime
Untuk mengimpor:
| Metode | Signature | Event server | Deskripsi |
|---|---|---|---|
| connect | session.createdSesi dibuatsession.updated Konfigurasi sesi diperbarui | Membuka koneksi WebSocket ke server. | |
| updateSession | session.updatedKonfigurasi sesi diperbarui | Memperbarui konfigurasi sesi. Lihat Parameter permintaan.Setelah terhubung, server mengembalikan konfigurasi input dan output default untuk sesi. Panggil metode ini segera setelah connect() untuk mengganti nilai default.Server memvalidasi parameter saat menerima event session.update. Jika ada parameter yang tidak valid, server mengembalikan error. Jika tidak, server memperbarui konfigurasi sesi di sisi server. | |
| appendText | Tidak ada | Menambahkan segmen teks ke buffer input sisi server. Buffer menyimpan teks hingga Anda mengirimkannya.
| |
| clearAppendedText | input_text_buffer.clearedMenghapus teks yang diterima oleh server | Menghapus semua teks dalam buffer input sisi server. | |
| commit | input_text_buffer.committedCommit teks dan picu sintesis suararesponse.output_item.added Konten output baru muncul dalam responsresponse.content_part.added Konten output baru ditambahkan ke item pesan asistenresponse.audio.deltaModel menghasilkan audio secara inkrementalresponse.audio.doneGenerasi audio selesairesponse.content_part.doneStreaming konten audio untuk pesan asisten selesairesponse.output_item.doneStreaming seluruh item output untuk pesan asisten selesairesponse.doneRespons selesai | Commit teks yang sebelumnya ditambahkan ke buffer sisi server dan langsung mensintesis semua teks. Mengembalikan error jika buffer kosong.
| |
| finish | session.finishedRespons selesai | Menghentikan tugas saat ini. | |
| close | Tidak ada | Menutup koneksi. | |
| getSessionId | Tidak ada | Mengembalikan ID sesi dari tugas saat ini. | |
| getResponseId | Tidak ada | Mengembalikan ID respons dari respons terbaru. | |
| getFirstAudioDelay | Tidak ada | Mengembalikan latensi paket audio pertama dalam milidetik. |
Antarmuka callback (QwenTtsRealtimeCallback)
| Metode | Parameter | Nilai kembali | Deskripsi |
|---|---|---|---|
| Tidak ada | Tidak ada | Dipanggil segera setelah koneksi WebSocket terbentuk. | |
| message: event respons sisi server. | Tidak ada | Dipanggil ketika server mengirim event, termasuk respons panggilan API dan audio yang dihasilkan model. Lihat Event sisi server. | |
| code: kode status penutupan WebSocket.reason: alasan penutupan. | Tidak ada | Dipanggil setelah server menutup koneksi. |