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.
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.Konfigurasikan koneksi
Opsi umum
| Parameter | Tipe | Deskripsi |
|---|---|---|
ApiKey | string? | API key; jika tidak diatur, baca DASHSCOPE_API_KEY. |
WorkspaceId | string? | ID workspace, dikirim melalui X-DashScope-WorkSpace. |
Url | string | URL 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.
| Kemampuan | URL |
|---|---|
| Qwen-Audio / Fun-ASR-Realtime / CosyVoice / Qwen-Audio-TTS-Next | wss://WorkspaceId.ap-southeast-1.maas.aliyuncs.com/api-ws/v1/inference |
| Multimodal realtime / Percakapan suara realtime / Terjemahan audio dan video realtime | wss://WorkspaceId.ap-southeast-1.maas.aliyuncs.com/api-ws/v1/realtime |
| Qwen-Audio-ASR-Filetrans / Fun-ASR | https://WorkspaceId.ap-southeast-1.maas.aliyuncs.com/api/v1/services/audio/asr/transcription |
| Qwen-Audio-ASR / Fun-ASR-Flash | https://WorkspaceId.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation |
| Paraformer · Pengenalan ucapan realtime | wss://WorkspaceId.cn-beijing.maas.aliyuncs.com/api-ws/v1/inference |
| Paraformer · Pengenalan ucapan non-real-time | https://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.
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.
| Jenis | Model yang didukung | Klien C# |
|---|---|---|
| Multimodal realtime |
| QwenRealtimeConversation |
| Pengenalan ucapan realtime |
| FunAsrSpeechTranscriber |
| Sintesis ucapan realtime |
| CosyVoiceSpeechSynthesizer |
| Generasi Audio |
| CosyVoiceSpeechSynthesizer |
| Percakapan suara realtime |
| QwenRealtimeConversation |
| Terjemahan audio dan video realtime |
| QwenLiveTranslator |
| Pengenalan ucapan non-real-time (asinkron) |
| FunAsrFileTranscriber |
| Pengenalan ucapan non-real-time (satu permintaan) |
| FunAsrFlashFileTranscriber |
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 kesalahan | DashScopeErrorCode | Deskripsi |
|---|---|---|
| 240001 | ConfigInvalid | Konfigurasi tidak valid. |
| 240002 | IllegalParam | Parameter tidak valid atau tidak ada. |
| 240014 | StateInvalid | Operasi tidak diizinkan pada status saat ini. |
| 240051 | UpdateAudioError | Gagal mengirim audio. |
| 240062 | NetworkError | Kesalahan jaringan atau koneksi. |
| 240069 | SocketClosed | Koneksi ditutup; periksa pesan untuk membedakan pembatalan lokal dari penutupan oleh server. |
| 240070 | AuthFailed | Autentikasi gagal. |
| 240072 | HttpSendFailed | Permintaan HTTP gagal dikirim. |
| 240073 | HttpReceiveFailed | Badan respons HTTP kosong. |
| 240074 | HttpResponseInvalid | JSON tidak valid atau kolom wajib tidak ada. |
| 240075 | HttpServerError | Server mengembalikan kesalahan; periksa kolom kesalahan server. |
| 240080 | ServerError | Layanan mengembalikan task-failed. Periksa ServerErrorCode. |
| 240091 | ConnectionTimeout | Batas waktu koneksi. |
| 240092 | StartTimeout | Batas waktu menunggu peristiwa mulai tugas. |
| 240093 | StopTimeout | Batas waktu menunggu penyelesaian tugas. |