Akses WebSocket Qwen-LiveTranslate-Realtime
Cakupan penggunaan
Dokumen ini ditujukan untuk Qwen-LiveTranslate-Realtime dengan model contoh qwen3.8-livetranslate-flash-realtime. Panduan seri juga mencakup qwen3.5-livetranslate-flash-realtime dan versi snapshot qwen3.5-livetranslate-flash-realtime-2026-05-19. Konfigurasi dan bidang peristiwa berbeda antara 3.8 dan 3.5. Lihat referensi peristiwa untuk model yang dipilih.
- Gunakan API Key dan ID ruang kerja yang sesuai dengan wilayah dan ruang kerja yang dipilih.
- Domain Beijing:
{WorkspaceId}.cn-beijing.maas.aliyuncs.com; domain Singapura:{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com. - Simpan API Key jangka panjang di server dan jangan letakkan dalam browser atau aplikasi seluler.
Alamat dan autentikasi
WebSocket
wss://WorkspaceId.cn-beijing.maas.aliyuncs.com/api-ws/v1/realtime?model=qwen3.8-livetranslate-flash-realtimeWebSocket
wss://WorkspaceId.ap-southeast-1.maas.aliyuncs.com/api-ws/v1/realtime?model=qwen3.8-livetranslate-flash-realtimeAuthorization: Bearer <API_KEY> dalam header permintaan handshake WebSocket. Ganti ID ruang kerja dan nama model yang sebenarnya. Jangan letakkan API Key jangka panjang di browser atau aplikasi seluler.
Header permintaan opsional user-agent digunakan untuk mengidentifikasi klien. Dokumentasi integrasi WebSocket umum juga mencantumkan X-DashScope-WorkSpace (ID ruang kerja) dan X-DashScope-DataInspection (konfigurasi pemeriksaan kepatuhan data), yang digunakan sesuai persyaratan model.
Untuk cara membuat API Key sementara dan izinnya, lihat Membuat API Key sementara.
Konfigurasi sesi
Kirim session.update setelah membuat koneksi dan menerima session.created. Kirim input hanya setelah menerima konfirmasi session.updated. Tangani error melalui peristiwa error.
Contoh berikut berlaku untuk qwen3.8-livetranslate-flash-realtime. Versi lain harus menggunakan konfigurasi dari referensi peristiwanya masing-masing. Jangan mencampur tingkat bidang. Contoh ini mengaktifkan kloning suara realtime. frequency: once mengekstrak suara input sekali pada awal sesi dan menggunakannya kembali, sehingga cocok untuk skenario satu orang. Untuk detailnya, lihat Kloning suara.
qwen3.5-livetranslate-flash-realtime, konfigurasi dan peristiwa berbeda dari contoh 3.8 di atas:
- Mode output menggunakan
modalitiesdalamsession. Nilai yang tersedia dan default-nya sama denganoutput_modalitiespada 3.8. - Bahasa sumber dapat ditentukan melalui
languagedalam objekinput_audio_transcriptionpadasession. Jika dihilangkan, pengenalan otomatis digunakan. - Pengenalan teks sumber inkremental menggunakan
conversation.item.input_audio_transcription.text, sedangkan 3.8 menggunakanconversation.item.input_audio_transcription.delta. - Untuk output teks saja, 3.5 mengembalikan terjemahan inkremental melalui
response.text.text, sedangkan 3.8 menggunakanresponse.text.delta. Untuk output teks dan audio, 3.5 mengembalikan terjemahan inkremental melaluiresponse.audio_transcript.text, sedangkan 3.8 menggunakanresponse.audio_transcript.delta.
Input, hasil, dan penghentian
Audio dikirim melalui input_audio_buffer.append. Format input, kondisi pengiriman, dan pembatasan input gambar dijelaskan dalam Peristiwa klien. Tangani hasil, status, dan error dalam Peristiwa server. Jangan menganggap pembuatan koneksi sebagai selesainya permintaan bisnis.
Terjemahan realtime menggunakan konfigurasi dan peristiwa terjemahan model ini. Jangan terapkan alur percakapan response.create milik Omni. Setelah input berakhir, kirim session.finish, pertahankan koneksi, dan terus terima hasil yang tersisa. Tutup koneksi WebSocket hanya setelah menerima session.finished. Jika audio terjemahan perlu diputar seluruhnya, selesaikan pemutaran lokal terlebih dahulu. Detail bidang peristiwa tersedia dalam Peristiwa klien dan Peristiwa server.
Penanganan kesalahan
Jika handshake gagal, periksa domain, region, ruang kerja, API Key, nama model, status aktivasi model, dan izin. Setelah koneksi dibuat, identifikasi masalah berdasarkan peristiwa error dan lihat Kode error. Simpan ID peristiwa untuk pemecahan masalah. Jangan menganggap protokol tidak didukung hanya karena tidak ada respons.