Gunakan C# SDK untuk memanggil Qwen-LiveTranslate-Realtime melalui WebSocket dan menerjemahkan ucapan menjadi teks serta audio dalam bahasa tujuan.
Prasyarat
Dapatkan kunci API dan simpan nilainya di variabel lingkungan DASHSCOPE_API_KEY. Gunakan kunci API dari wilayah yang sama dengan workspace Anda.
Instal SDK
Unduh dan ekstrak Bailian.DashScope-1.1.0.zip. Untuk menggunakan SDK dalam proyek C#, instal dari sumber lokal NuGet.
Mulai cepat
Menjalankan contoh bawaan
- Buat proyek konsol .NET 10 dan instal SDK seperti dijelaskan di atas.
- Simpan
input.pcmdi direktori proyek. Gunakan PCM mentah 16 kHz, mono, 16-bit little-endian. Konversikan berkas WAV ke PCM mentah terlebih dahulu.
WorkspaceId dengan ID workspace Anda. Untuk daftar wilayah dan endpoint yang didukung, lihat Akses WebSocket.
Memanggil SDK dalam proyek
Program ini mengalirkan rekaman raw PCM secara real time, menunggu hingga respons selesai, lalu menulis audio ke output.pcm. Ganti Program.cs dengan kode berikut.
Parameter permintaan
| Opsi | Tipe | Default | Deskripsi |
|---|---|---|---|
ApiKey | string? | null | Kunci API Model Studio. Jika diabaikan, SDK membaca DASHSCOPE_API_KEY. |
Url | string | wss://dashscope.aliyuncs.com/api-ws/v1/realtime | Endpoint WebSocket. SDK menambahkan Model sebagai parameter query model. |
WorkspaceId | string? | null | ID workspace yang dikirim dalam header X-DashScope-WorkSpace. Untuk menggunakan endpoint khusus workspace, atur alamat lengkap di Url. |
ConnectTimeout | TimeSpan | 10 s | Waktu tunggu pembukaan koneksi WebSocket. |
StartTimeout | TimeSpan | 10 s | Waktu tunggu penerimaan session.created. |
StopTimeout | TimeSpan | 10 s | Waktu tunggu penerimaan session.finished saat mode selesai menunggu peristiwa tersebut. |
FinishMode | QwenRealtimeFinishMode? | null | Jika diabaikan, SDK memilih mode selesai berdasarkan model. Baca FinishMode pada instance untuk melihat mode apa yang digunakan. |
Model | string | qwen3.5-livetranslate-flash-realtime | ID model. |
Modalities | IList<string> | ["text", "audio"] | Moda output. Gunakan ["text"] jika hanya ingin teks terjemahan. |
Voice | string? | null | Suara untuk audio terjemahan. Jika diabaikan, server akan memilih suara default. Saat menghasilkan audio dengan versi 3.8, tentukan suara yang didukung oleh model tersebut. |
EnableVoiceClone | bool? | null | Mengaktifkan kloning suara untuk audio yang diterjemahkan. |
VoiceCloneFrequency | string | once | once mengkloning suara di awal sesi, always mengkloningnya untuk setiap kalimat, dan never menggunakan ID suara yang sudah dikloning. Periksa mode mana yang didukung oleh model Anda. |
SampleRate | int | 16000 | Laju sampel input dalam Hz. Pilih laju sampel yang didukung oleh model Anda. |
InputAudioFormat | string | pcm | Format audio input. Opsi SDK menerima pcm atau opus. Periksa referensi acara klien untuk format yang didukung oleh model Anda. |
OutputAudioFormat | string? | null | Format audio output, seperti pcm. Jika dilewatkan, server menggunakan nilai default-nya. |
TranscriptionModel | string? | qwen3-asr-flash-realtime | Model untuk pengenalan ucapan sumber. Dengan qwen3.5-livetranslate-flash-realtime, atur kedua opsi ini dan SourceLanguage ke null agar menghilangkan input_audio_transcription. Pengenalan ucapan sumber selalu aktif pada versi 3.8. |
SourceLanguage | string? | null | Kode bahasa sumber, seperti zh. Jika dilewatkan, server akan mendeteksi bahasanya. |
TargetLanguage | string | en | Kode bahasa tujuan, seperti en. |
SkipSameLanguageText | bool? | null | Melewatkan teks terjemahan ketika bahasa sumber dan tujuan sama. Periksa apakah versi model Anda mendukung opsi ini. |
SkipSameLanguageAudio | bool? | null | Melewatkan audio terjemahan ketika bahasa sumber dan tujuan sama. Periksa apakah versi model Anda mendukung opsi ini. |
CorpusPhrases | IDictionary<string, string>? | null | Glosarium terjemahan yang memetakan istilah sumber ke istilah tujuan dalam translation.corpus.phrases. |
VadThreshold | double? | 0.5 | Ambang VAD server dari -1,0 hingga 1,0. |
VadSilenceMs | int | 1000 | Durasi keheningan dalam milidetik sebelum server mendeteksi akhir ucapan. |
EnableDebugInfo | bool? | null | Meminta informasi debug dari server. |
session.input_modalities ke ["audio", "video"] seperti yang ditunjukkan di WebSocket akses, lalu kirim frame gambar bersamaan dengan audio. AppendImageAsync mengirim frame gambar. Gunakan SendRawEventAsync untuk mengirim acara klien lengkap untuk bidang tanpa opsi SDK khusus.
Referensi API
Gunakan DashScope.Qwen.QwenLiveTranslator bersama QwenLiveTranslateOptions. Beberapa pengaturan sesi dan bidang peristiwa berbeda antara versi 3.5 dan 3.8. Lihat referensi acara klien untuk model Anda.
Metode
Metode di bawah ini mengembalikan Task, kecuali DisposeAsync. ct adalah token pembatalan opsional.
| Metode | Deskripsi |
|---|---|
ConnectAsync(CancellationToken ct = default) | Membuka koneksi, menunggu session.created, dan mengirim session.update. |
AppendAudioAsync(ReadOnlyMemory<byte> pcm, CancellationToken ct = default) | Mengirim frame audio. SDK mengenkripsi byte secara Base64 dan mengirim acara input_audio_buffer.append. |
AppendImageAsync(string imageBase64, CancellationToken ct = default) | Mengirim frame gambar Base64 dalam input_image_buffer.append. Pilih model yang mendukung input gambar dan aktifkan input audio dan gambar terlebih dahulu. |
SendRawEventAsync(string frameJson, CancellationToken ct = default) | Mengirim JSON acara klien lengkap seperti yang diberikan. Gunakan metode ini untuk acara tanpa metode SDK khusus. |
FinishAsync(CancellationToken ct = default) | Mengakhiri sesi menggunakan FinishMode aktif. |
AbortAsync() | Menutup koneksi secara langsung dan membuang hasil yang belum diproses. |
DisposeAsync() | Melepaskan sumber daya secara asinkron dan mengembalikan ValueTask. |
Acara
| Acara | Argumen acara | Kapan acara dipicu |
|---|---|---|
SessionReady | string? | Sesi siap. Nilainya adalah session.id. |
SourceTranscriptUpdated | QwenTranscriptEventArgs | Transkrip sumber saat ini. Dikembalikan ketika pengenalan ucapan sumber diaktifkan. |
SourceTranscriptCompleted | QwenTranscriptEventArgs | Transkrip akhir dari ucapan sumber. |
TranslationTextDelta | QwenTextDeltaEventArgs | Delta terjemahan. Baca TranslationCompleted untuk terjemahan akhir. |
TranslationCompleted | QwenTranscriptEventArgs | Terjemahan lengkap untuk ucapan tersebut. |
TranslatedAudioChunk | QwenAudioChunkEventArgs | Bagian audio terjemahan. Format dan laju sampel tergantung pada konfigurasi sesi dan respons model. |
TranslatedAudioCompleted | EventArgs | Semua audio terjemahan untuk giliran telah tiba. |
ResponseCompleted | QwenResponseSummary | response.done tiba dengan status dan penggunaan. |
RawServerEvent | QwenServerEventArgs | Acara server mentah dengan jenisnya dan objek JSON-nya. |
ErrorOccurred | DashScopeErrorEventArgs | Terjadi kesalahan server atau kegagalan koneksi. |
Mengakhiri sesi
Setelah mengirim semua audio, panggil FinishAsync untuk mengakhiri sesi dan menerima sisa terjemahan serta audio terjemahan. Secara default, LiveTranslate menggunakan FinishAndWait, yang mengirim session.finish dan menunggu session.finished.