Skip to main content

Akses WebSocket Qwen-LiveTranslate-Realtime

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

WebSocketwss://WorkspaceId.cn-beijing.maas.aliyuncs.com/api-ws/v1/realtime?model=qwen3.8-livetranslate-flash-realtime
WebSocketwss://WorkspaceId.ap-southeast-1.maas.aliyuncs.com/api-ws/v1/realtime?model=qwen3.8-livetranslate-flash-realtime

Untuk domain lainnya, lihat SDK Python. Atur Authorization: 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.
{
  "type": "session.update",
  "session": {
    "output_modalities": [
      "text",
      "audio"
    ],
    "audio": {
      "input": {
        "turn_detection": {
          "type": "speaker_detection",
          "threshold": 0.5
        }
      }
    },
    "voice": "default",
    "enable_voice_clone": true,
    "voice_clone_options": {
      "frequency": "once"
    },
    "translation": {
      "language": "en",
      "corpus": {
        "phrases": {
          "人工智能": "Artificial Intelligence",
          "机器学习": "Machine Learning"
        }
      }
    }
  }
}
Saat menggunakan qwen3.5-livetranslate-flash-realtime, konfigurasi dan peristiwa berbeda dari contoh 3.8 di atas:
  • Mode output menggunakan modalities dalam session. Nilai yang tersedia dan default-nya sama dengan output_modalities pada 3.8.
  • Bahasa sumber dapat ditentukan melalui language dalam objek input_audio_transcription pada session. Jika dihilangkan, pengenalan otomatis digunakan.
  • Pengenalan teks sumber inkremental menggunakan conversation.item.input_audio_transcription.text, sedangkan 3.8 menggunakan conversation.item.input_audio_transcription.delta.
  • Untuk output teks saja, 3.5 mengembalikan terjemahan inkremental melalui response.text.text, sedangkan 3.8 menggunakan response.text.delta. Untuk output teks dan audio, 3.5 mengembalikan terjemahan inkremental melalui response.audio_transcript.text, sedangkan 3.8 menggunakan response.audio_transcript.delta.
Untuk bidang lengkap, default, dan peristiwa, lihat Peristiwa klien, Peristiwa server, dan Panduan terjemahan suara realtime.

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.

SDK dan referensi

SDK yang tersedia