Dokumen ini menjelaskan cara menggunakan SDK Python DashScope untuk memanggil model terjemahan audio dan video realtime (Qwen-LiveTranslate-Realtime).
Prasyarat
- Instal SDK. Pastikan versi DashScope SDK Anda adalah 1.25.6 atau lebih baru.
- Dapatkan Kunci API.
Mulai cepat
Contoh ini merekam audio dari mikrofon dan menerjemahkannya secara real-time.
Kode contoh untuk terjemahan real-time dari mikrofon
Kode contoh untuk terjemahan real-time dari mikrofon
Parameter permintaan
-
Tetapkan parameter berikut dalam konstruktor kelas
OmniRealtimeConversation.Klik untuk melihat contoh kode
Parameter Tipe Wajib Deskripsi modelstrYa Nama model yang digunakan. Tetapkan nilai ini ke qwen3.5-livetranslate-flash-realtime(direkomendasikan).callbackOmniRealtimeCallbackYa Instans callback untuk menangani event sisi server. urlstrYa Titik akhir layanan untuk terjemahan real-time: - China (Beijing):
wss://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api-ws/v1/realtime - Singapura:
wss://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api-ws/v1/realtime
{WorkspaceId}dengan ID ruang kerja Anda yang sebenarnya. - China (Beijing):
-
Tetapkan parameter berikut menggunakan metode
update_sessiondari kelasOmniRealtimeConversation.Klik untuk melihat contoh kode
Parameter
Tipe
Wajib
Deskripsi
output_modalitiesList[MultiModality]Tidak
Format output untuk hasil terjemahan.
Default:
[MultiModality.TEXT, MultiModality.AUDIO].Nilai yang valid:
[MultiModality.TEXT]: Hanya menghasilkan teks[MultiModality.TEXT, MultiModality.AUDIO]: Menghasilkan teks dan audio
voicestrTidak
Suara untuk output audio.
Default:
Qwen3.5-LiveTranslate-Flash-Realtime:
Tina
Nilai yang valid: Suara yang didukung.
input_audio_transcription_modelstrTidak
Tetapkan parameter ini ke
qwen3-asr-flash-realtimeuntuk menerima hasil pengenalan ucapan dalam bahasa sumber.translation_paramsTranslationParamsTidak
Pengaturan terjemahan (bahasa target dan hotword).
enable_turn_detectionboolTidak
Apakah akan mengaktifkan VAD (Voice Activity Detection).
Nilai default:
True, yang mengaktifkan mode VAD di mana server secara otomatis mendeteksi awal/akhir ucapan dan memicu terjemahan.Tetapkan ke
Falseuntuk beralih ke mode Manual, di mana klien secara manual mengirimkan audio melalui metodecommit. Untuk deskripsi parameter lengkap, lihat penjelasanturn_detectiondalam dokumen Client events. -
Tetapkan parameter berikut dalam konstruktor kelas
TranslationParams.Klik untuk melihat contoh kode
Parameter
Tipe
Wajib
Deskripsi
languagestrTidak
Bahasa target untuk terjemahan.
Default:
en.Nilai yang valid: Bahasa yang didukung.
corpusTranslationParams.CorpusTidak
Pemetaan hotword untuk meningkatkan akurasi terjemahan istilah tertentu.
corpus.phrasesdictTidak
Tabel pemetaan hotword di mana kunci adalah istilah sumber dan nilai adalah terjemahan target.
Contoh:
{'Inteligencia Artificial': 'Artificial Intelligence'}
Referensi API
Kelas OmniRealtimeConversation
Impor: from dashscope.audio.qwen_omni import OmniRealtimeConversation
| Signature metode | Event respons sisi server (dikirim melalui callback) | Deskripsi |
|---|---|---|
Event sisi serverSesi dibuatEvent sisi server Konfigurasi sesi diperbarui | Terhubung ke server. | |
Sesi diperbaruiSesi diperbarui | Perbarui konfigurasi sesi. Panggil segera setelah terhubung. Jika Anda tidak memanggil metode ini, konfigurasi default akan diterapkan. | |
session.finishedServer menyelesaikan terjemahan ucapan dan mengakhiri sesi | Akhiri sesi. Server menyelesaikan pemrosesan terjemahan akhir. | |
| None | Kirim chunk audio yang dikodekan Base64 ke server. Deteksi ucapan dan terjemahan dilakukan secara otomatis. | |
Event sisi serverBuffer audio input dikomit | Dalam mode Manual, kirimkan audio yang sebelumnya ditambahkan ke buffer server melalui metode append_audio. Server secara otomatis mulai menghasilkan respons terjemahan setelah menerima data. Dalam mode VAD, metode ini tidak perlu dipanggil karena server melakukan komit secara otomatis. | |
Event sisi serverBuffer audio input dihapus | Hapus data audio yang belum dikomit dalam buffer server saat ini. | |
| None | Hentikan tugas dan tutup koneksi. | |
| None | Dapatkan ID sesi. | |
| None | Dapatkan ID respons terakhir. |
Antarmuka callback (OmniRealtimeCallback)
Terima event dan data server melalui callback.
Wariskan kelas ini dan implementasikan metodenya untuk menangani event dari server.
Impor: from dashscope.audio.qwen_omni import OmniRealtimeCallback
| Signature metode | Parameter | Deskripsi |
|---|---|---|
| None | Dipanggil ketika koneksi WebSocket terbuka. | |
| message: Event sisi server | Dipanggil ketika server mengirimkan event. | |
| close_status_code: Kode status.close_msg: Pesan log saat koneksi WebSocket ditutup. | Dipanggil ketika koneksi WebSocket ditutup. |
dashscope.Client(): menerima event setelah error
Saat menggunakan dashscope.Client() pada DashScope SDK 2.x, terima event melalui events() atau recv_event() pada sesi. Lihat Iterasi event Python SDK 2.x untuk penggunaan lengkap.
Saat Anda menangkap DashScopeError, iterator events() yang sedang digunakan sudah berakhir. Menangkap exception dengan try/except di luar iterator tidak memulai ulang penerimaan event.
Jika koneksi WebSocket masih dapat digunakan, perbaiki permintaan lalu panggil kembali events(), atau gunakan recv_event() untuk menerima event satu per satu. Jika koneksi sudah ditutup, hubungkan kembali dan konfigurasikan sesi baru terlebih dahulu, lalu lanjutkan penerimaan event.
Untuk menelusuri penyebab error, baca event error asli dari server melalui body pada exception.