Prasyarat
Versi DashScope Python SDK harus 2.0.1 atau lebih baru.
Mulai cepat
Parameter permintaan
Parameter permintaan berikut dapat diatur melalui metode connect pada client.audio.realtime.
Parameter | Type | Wajib | Deskripsi |
|---|---|---|---|
model | str | Ya | Nama model (lihat Model yang didukung). |
ws_url | str | Tidak | Endpoint sesi. Jika tidak diatur, akan otomatis ditentukan oleh parameter konstruktor |
update_session pada sesi (parameter bernama diteruskan langsung, dan parameter lainnya diteruskan ke objek session pada event session.update).
Parameter | Type | Wajib | Deskripsi |
|---|---|---|---|
voice | str | Ya | Voice untuk sintesis suara. Untuk informasi selengkapnya, lihat Daftar voice Qwen-TTS. |
language_type | str | Tidak | Menentukan bahasa audio hasil sintesis. Nilai default adalah
|
mode | str | Tidak | Mode interaksi. Nilai yang valid:
|
response_format | str | Tidak | Format output audio dari model. Format yang didukung:
|
sample_rate | int | Tidak | Laju sampel output audio dari model, dalam Hz. Laju sampel yang didukung:
|
speech_rate | float | Tidak | Laju 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]. |
pitch_rate | float | Tidak | Pitch audio hasil sintesis. Nilai default: 1.0. Rentang valid: [0.5, 2.0]. |
bit_rate | 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
Sesi (RealtimeSession)
Sesi sintesis ucapan real-time dibuat melalui client.audio.realtime.connect(model=...); memasuki konteks with akan otomatis membentuk koneksi (Anda juga dapat memanggil metode connect() pada sesi untuk membentuknya secara manual).
| Signature metode | Event respons server (dikirimkan melalui iterasi events()) | Deskripsi |
|---|---|---|
session.createdSesi dibuatsession.updated Konfigurasi sesi diperbarui | Membentuk koneksi dengan server. Dipanggil otomatis saat memasuki konteks with. | |
session.updatedKonfigurasi sesi diperbarui | Perbarui konfigurasi sesi default. Untuk detail parameter, lihat Parameter permintaan.Setelah terhubung, server mengembalikan konfigurasi input dan output default. Panggil metode ini segera setelah terhubung untuk memperbarui default tersebut.Server memvalidasi parameter saat menerima event session.update. Jika validasi gagal, server mengembalikan error; jika tidak, konfigurasi sesi diperbarui. | |
| Tidak ada | Mengirim event mentah. Input teks diselesaikan melalui rangkaian event input_text_buffer: potongan teks ditambahkan ke buffer teks input di cloud ({"type": "input_text_buffer.append", "text": ...}). Buffer adalah penyimpanan sementara yang dapat Anda tulis dan kemudian dikirim.
| |
input_text_buffer.clearedMengosongkan teks yang diterima server | Mengirim event {"type": "input_text_buffer.clear"} untuk menghapus teks dalam buffer cloud saat ini. | |
input_text_buffer.committedKirim teks dan picu sintesis suararesponse.output_item.added Konten output baru ditambahkanresponse.content_part.added Konten baru ditambahkan ke pesan asistenresponse.audio.delta Audio inkremental yang dihasilkan modelresponse.audio.done Generasi audio selesairesponse.content_part.done Streaming konten audio untuk pesan asisten selesairesponse.output_item.done Streaming seluruh item output untuk pesan asisten selesairesponse.done Respons selesai | Kirim semua teks dalam buffer cloud dan langsung lakukan sintesis. Mengembalikan error jika buffer kosong.
| |
session.finishedRespons selesai | Mengirim event session.finish untuk mengakhiri tugas. Setelah itu, terus konsumsi events() hingga event session.finished. | |
| Tidak ada | Menutup koneksi. Dipanggil otomatis saat keluar dari konteks with. | |
| Tidak ada | Dapatkan ID sesi untuk tugas saat ini. | |
| Tidak ada | Dapatkan ID respons dari respons terbaru. | |
| Tidak ada | Dapatkan penundaan sebelum paket audio pertama tiba. |
Iterasi event (events())
Server mengembalikan event respons dan data kepada klien dalam bentuk event. Iterasikan events() sesi di thread penerima untuk memproses event server; iterasi berakhir setelah event session.finished; event error akan dilempar sebagai pengecualian DashScopeError dan dapat ditangkap menggunakan try/except.
| Metode | Parameter | Nilai kembalian | Deskripsi |
|---|---|---|---|
event: Event respons server (dict). | Iterator | Mencakup respons panggilan antarmuka serta teks dan audio yang dihasilkan model; iterasi berakhir setelah event session.finished. Untuk detailnya, lihat Event server | |
event: Event respons server (dict). | Event atau None | Membaca satu event server; mengembalikan None setelah penutupan normal. |