Skip to main content

Integrasi SDK

Instal dan konfigurasikan C# SDK Model Studio, pilih klien untuk keluarga model Anda, dan tangani penyelesaian tugas, batas waktu, serta error.

Mulai menggunakan SDK

Prasyarat

  • Instal .NET 8 SDK atau .NET 10 SDK.
  • Dapatkan API key, lalu atur variabel lingkungan DASHSCOPE_API_KEY.
Simpan API key jangka panjang di server. Jangan sematkan kunci di aplikasi desktop, seluler, atau browser yang Anda distribusikan. Untuk panduannya, lihat Lindungi kunci API.

Instal SDK

Unduh dan ekstrak Bailian.DashScope-1.1.1.zip. Nama paket NuGet adalah Bailian.DashScope, assembly-nya DashScope.dll, dan namespace akarnya DashScope. Tidak ada dependensi pustaka native atau paket NuGet transitif.
  • Sumber NuGet lokal (disarankan)
  • Referensikan DLL secara langsung
Gunakan direktori packages/ yang telah diekstrak sebagai sumber NuGet lokal.
Contoh berikut menggunakan .NET 8. Untuk .NET 10, ganti net8.0 dengan net10.0 dalam perintah dan jalur.
dotnet new console --framework net8.0 --name SpeechExample
cd SpeechExample
dotnet add package Bailian.DashScope --version 1.1.1 --source "/path/to/Bailian.DashScope-1.1.1/packages"
Untuk memverifikasi unduhan, jalankan perintah ini dari direktori paket yang telah diekstrak:
shasum -a 256 -c SHA256SUMS.txt

Konfigurasikan koneksi

Opsi umum

ParameterTipeDeskripsi
ApiKeystring?API key; jika tidak diatur, baca DASHSCOPE_API_KEY.
WorkspaceIdstring?ID workspace, dikirim melalui X-DashScope-WorkSpace.
UrlstringURL endpoint lengkap.

Konfigurasikan URL endpoint

WorkspaceId hanya menambahkan header workspace, bukan mengubah endpoint. Atur endpoint workspace lengkap di Url. Untuk interaksi multimodal, percakapan suara, serta terjemahan audio dan video secara real-time, SDK menambahkan nama model ke URL WebSocket sebagai parameter kueri model. Untuk pengenalan ucapan, sintesis ucapan, dan pembuatan audio, nama model dikirim dalam isi permintaan.
KemampuanURL
Qwen-Audio / Fun-ASR-Realtime / CosyVoice / Qwen-Audio-TTS-Nextwss://WorkspaceId.ap-southeast-1.maas.aliyuncs.com/api-ws/v1/inference
Multimodal realtime / Percakapan suara realtime / Terjemahan audio dan video realtimewss://WorkspaceId.ap-southeast-1.maas.aliyuncs.com/api-ws/v1/realtime
Qwen-Audio-ASR-Filetrans / Fun-ASRhttps://WorkspaceId.ap-southeast-1.maas.aliyuncs.com/api/v1/services/audio/asr/transcription
Qwen-Audio-ASR / Fun-ASR-Flashhttps://WorkspaceId.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
Paraformer · Pengenalan ucapan realtimewss://WorkspaceId.cn-beijing.maas.aliyuncs.com/api-ws/v1/inference
Paraformer · Pengenalan ucapan non-real-timehttps://WorkspaceId.cn-beijing.maas.aliyuncs.com/api/v1/services/audio/asr/transcription

Verifikasi instalasi dan konfigurasi

Jalankan perintah berikut di direktori demo/DashScope.Cli/ hasil ekstraksi. Contoh ini mengonversi audio ke PCM mono 16 kHz untuk pengenalan ucapan real-time. Ganti WorkspaceId dengan ID ruang kerja untuk API key Anda.
dotnet build -p:TargetFrameworks=net8.0
curl -fL "https://dashscope.oss-cn-beijing.aliyuncs.com/samples/audio/paraformer/hello_world_female2.wav" -o input.wav
ffmpeg -i input.wav -f s16le -ac 1 -ar 16000 input.pcm
dotnet bin/Debug/net8.0/DashScope.Cli.dll asr --audio input.pcm --model qwen-audio-3.1-asr-flash-streaming --url "wss://WorkspaceId.ap-southeast-1.maas.aliyuncs.com/api-ws/v1/inference"

Kemampuan dan model yang didukung

SDK .NET terkelola ini mengirim audio atau teks dan menerima hasil. SDK tidak menyediakan perekaman, codec, deteksi kata pemicu, VAD lokal, atau peredam gema.
JenisModel yang didukungKlien C#
Multimodal realtime
  • Qwen-Omni-Realtime: qwen3.8-omni-flash-realtime, qwen3.5-omni-plus-realtime, qwen3.5-omni-plus-realtime-2026-03-15, qwen3.5-omni-flash-realtime, qwen3.5-omni-flash-realtime-2026-03-15, qwen3-omni-flash-realtime-2025-09-15
QwenRealtimeConversation
Pengenalan ucapan realtime
  • Qwen-Audio-ASR-Streaming: qwen-audio-3.1-asr-flash-streaming, qwen-audio-3.0-asr-flash-streaming
  • Qwen-Audio-ASR-Message: qwen-audio-3.1-asr-flash-message
  • Fun-ASR-Realtime: fun-asr-realtime, fun-asr-flash-8k-realtime, fun-asr-realtime-2026-02-28, fun-asr-flash-8k-realtime-2026-01-28
  • Paraformer: paraformer-realtime-v2, paraformer-realtime-8k-v2
FunAsrSpeechTranscriber
Sintesis ucapan realtime
  • Qwen-Audio-TTS: qwen-audio-3.1-tts-flash, qwen-audio-3.1-tts-plus, qwen-audio-3.0-tts-flash, qwen-audio-3.0-tts-plus
  • CosyVoice: cosyvoice-v3.5-plus, cosyvoice-v3.5-flash, cosyvoice-v3-flash, cosyvoice-v3-plus, cosyvoice-v2
CosyVoiceSpeechSynthesizer
Generasi Audio
  • Qwen-Audio-TTS-Next: qwen-audio-3.1-tts-next
CosyVoiceSpeechSynthesizer
Percakapan suara realtime
  • Qwen-Audio-Realtime: qwen-audio-3.1-realtime-plus, qwen-audio-3.1-realtime-flash, qwen-audio-3.0-realtime-plus, qwen-audio-3.0-realtime-flash
QwenRealtimeConversation
Terjemahan audio dan video realtime
  • Qwen-LiveTranslate-Realtime: qwen3.5-livetranslate-flash-realtime, qwen3.5-livetranslate-flash-realtime-2026-05-19, qwen3.8-livetranslate-flash-realtime
QwenLiveTranslator
Pengenalan ucapan non-real-time (asinkron)
  • Qwen-Audio-ASR-Filetrans: qwen-audio-3.1-asr-flash-filetrans, qwen-audio-3.0-asr-flash-filetrans
  • Fun-ASR: fun-asr
  • Paraformer: paraformer-v2, paraformer-8k-v2
FunAsrFileTranscriber
Pengenalan ucapan non-real-time (satu permintaan)
  • Qwen-Audio-ASR: qwen-audio-3.1-asr-flash, qwen-audio-3.0-asr-flash
  • Fun-ASR-Flash: fun-asr-flash-2026-06-15
FunAsrFlashFileTranscriber
Jalankan perintah berikut di direktori proyek demo yang telah dibangun untuk melihat ID model yang tercantum dalam demo.
dotnet bin/Debug/net8.0/DashScope.Cli.dll models --names-only

Catatan penggunaan

Kompatibilitas model dan suara

Jika satu kelas klien digunakan oleh beberapa keluarga model, tetapkan Model secara eksplisit. Jika tidak, SDK menggunakan model default kelas tersebut. Metode ModelRouting pada SDK mencocokkan beberapa keluarga model berdasarkan nama. Gunakan tabel model yang didukung di halaman ini untuk memilih klien. Jika mengganti model sintesis, pastikan suara didukung oleh model baru. Qwen-Audio-TTS dan CosyVoice menggunakan klien yang sama, tetapi daftar suaranya berbeda. Untuk memilih suara, lihat Daftar voice Qwen-Audio-TTS dan Daftar voice CosyVoice.

Selesaikan atau batalkan panggilan

  • Pengenalan ucapan realtime
  • Percakapan suara realtime
  • Pengenalan ucapan non-real-time
Untuk pengenalan realtime dan sintesis dupleks, tunggu StopAsync() untuk mendapatkan hasil akhir. Pemanggilan berikutnya tidak memicu peristiwa selesai lagi. CancelAsync() langsung memutus koneksi dan dapat dipanggil berulang kali.Jika dibatalkan saat StopAsync() menunggu, panggilan yang menunggu gagal dengan 240069. Memanggil StopAsync() setelah pembatalan menghasilkan 240014. Melepas tugas sebelum selesai melaporkan 240069 melalui Failed.

Kode error

Jika panggilan gagal, menunggu hasilnya dapat memicu DashScopeException. Untuk pengenalan ucapan dan sintesis ucapan real-time, gunakan peristiwa Failed untuk menerima error koneksi. Gunakan ServerErrorCode dan ServerErrorMessage untuk mendiagnosis error server. Saat menghubungi dukungan teknis, sertakan TaskId dan RequestId yang dikembalikan oleh panggilan, jika ada.
Kode kesalahanDashScopeErrorCodeDeskripsi
240001ConfigInvalidKonfigurasi tidak valid.
240002IllegalParamParameter tidak valid atau tidak ada.
240014StateInvalidOperasi tidak diizinkan pada status saat ini.
240051UpdateAudioErrorGagal mengirim audio.
240062NetworkErrorKesalahan jaringan atau koneksi.
240069SocketClosedKoneksi ditutup; periksa pesan untuk membedakan pembatalan lokal dari penutupan oleh server.
240070AuthFailedAutentikasi gagal.
240072HttpSendFailedPermintaan HTTP gagal dikirim.
240073HttpReceiveFailedBadan respons HTTP kosong.
240074HttpResponseInvalidJSON tidak valid atau kolom wajib tidak ada.
240075HttpServerErrorServer mengembalikan kesalahan; periksa kolom kesalahan server.
240080ServerErrorLayanan mengembalikan task-failed. Periksa ServerErrorCode.
240091ConnectionTimeoutBatas waktu koneksi.
240092StartTimeoutBatas waktu menunggu peristiwa mulai tugas.
240093StopTimeoutBatas waktu menunggu penyelesaian tugas.