Skip to main content

SDK の導入

Model Studio C# SDK のインストールと設定、モデルに応じたクライアントの選択、タスクの終了、タイムアウト、エラーの処理方法を説明します。

利用を開始する

事前準備

  • .NET 8 SDK または .NET 10 SDK をインストールします。
  • API キーの取得の手順に従い、環境変数 DASHSCOPE_API_KEY を設定します。
長期有効な API キーはサーバー側で保管し、配布するデスクトップ、モバイル、ブラウザーアプリには埋め込まないでください。保護方法は API キーの漏洩防止 を参照してください。

SDK のインストール

Bailian.DashScope-1.1.1.zip をダウンロードして展開します。 NuGet パッケージ名は Bailian.DashScope、アセンブリは DashScope.dll、ルート名前空間は DashScope です。ネイティブライブラリや追加の NuGet パッケージは不要です。
  • ローカル NuGet ソース(推奨)
  • DLL を直接参照する
展開した packages/ ディレクトリをローカル NuGet ソースに指定します。
以下の例は .NET 8 用です。.NET 10 では、コマンドとパスの net8.0 を net10.0 に置き換えてください。
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"
展開したパッケージのディレクトリで次を実行してファイルを検証できます。
shasum -a 256 -c SHA256SUMS.txt

接続の設定

共通パラメーター

パラメーター型説明
ApiKeystring?API キー。未設定時は DASHSCOPE_API_KEY を使用。
WorkspaceIdstring?X-DashScope-WorkSpace ヘッダーで送信するワークスペース ID。
Urlstring完全なエンドポイント URL。

エンドポイント URL の設定

WorkspaceId はワークスペースのリクエストヘッダーを追加するだけで、接続先は変更しません。Url にワークスペースの完全なエンドポイントを設定します。 リアルタイムのマルチモーダル対話、音声対話、音声・映像翻訳では、SDK がモデル名を WebSocket URL の model クエリパラメーターに追加します。音声認識、音声合成、オーディオ生成ではリクエスト本文で送信します。
機能URL
Qwen-Audio / Fun-ASR-Realtime / CosyVoice / Qwen-Audio-TTS-Nextwss://WorkspaceId.ap-southeast-1.maas.aliyuncs.com/api-ws/v1/inference
リアルタイムマルチモーダル / リアルタイム音声対話 / リアルタイム音声・動画翻訳wss://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 · リアルタイム音声認識wss://WorkspaceId.cn-beijing.maas.aliyuncs.com/api-ws/v1/inference
Paraformer · 非リアルタイム音声認識https://WorkspaceId.cn-beijing.maas.aliyuncs.com/api/v1/services/audio/asr/transcription

インストールと設定の確認

展開した demo/DashScope.Cli/ で次のコマンドを実行します。音声を 16 kHz のモノラル PCM に変換してリアルタイム音声認識を行います。WorkspaceId は API キーに対応するワークスペース ID に置き換えてください。
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"

対応機能とモデル

このマネージド .NET SDK は音声やテキストを送信して結果を受信します。録音、コーデック、ウェイクワード検出、端末側の VAD やエコーキャンセルは提供しません。
種類対応モデルC# クライアント
リアルタイムマルチモーダル
  • 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
リアルタイム音声認識
  • 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
リアルタイム音声合成
  • 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
音声生成
  • Qwen-Audio-TTS-Next:qwen-audio-3.1-tts-next
CosyVoiceSpeechSynthesizer
リアルタイム音声対話
  • 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
リアルタイム音声・動画翻訳
  • Qwen-LiveTranslate-Realtime:qwen3.5-livetranslate-flash-realtime、qwen3.5-livetranslate-flash-realtime-2026-05-19、qwen3.8-livetranslate-flash-realtime
QwenLiveTranslator
非リアルタイム音声認識(非同期)
  • 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
非リアルタイム音声認識(単一リクエスト)
  • 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
ビルド済みのサンプルプロジェクトのディレクトリで次のコマンドを実行すると、サンプルに収録されたモデル ID を表示できます。
dotnet bin/Debug/net8.0/DashScope.Cli.dll models --names-only

利用上の注意

モデルと音色の互換性

複数のモデル系列が同じクライアントクラスを使用する場合は、Model を明示的に指定してください。省略するとクラスの既定モデルが使用されます。SDK の ModelRouting メソッドは、一部のモデル系列を名前で判定します。モデルに対応するクライアントは、このページの対応モデル表で確認してください。 合成モデルを切り替える際は、選択した音色にそのモデルが対応しているか確認してください。Qwen-Audio-TTS と CosyVoice はクライアントを共有しますが、音色一覧は共通ではありません。音色の選択については Qwen-Audio-TTS の音声リスト と CosyVoice voice list を参照してください。

呼び出しの終了とキャンセル

  • リアルタイム音声認識
  • リアルタイム音声対話
  • 非リアルタイム音声認識
リアルタイム認識と双方向合成では StopAsync() で最終結果を待ちます。再度呼んでも完了イベントは再発生しません。結果を待たずに切断する CancelAsync() は複数回呼べます。StopAsync() の待機中にキャンセルすると待機中の呼び出しは 240069、キャンセル後に呼ぶと 240014 になります。終了前にリソースを解放すると Failed イベントで 240069 が通知されます。

エラーコード

呼び出しに失敗すると、結果を待機する際に DashScopeException が発生する場合があります。リアルタイム音声認識と音声合成では、Failed イベントで接続エラーも受け取れます。 サーバー側のエラーは ServerErrorCode と ServerErrorMessage で確認します。サポートに問い合わせる際は、呼び出しで返された TaskId と RequestId をお知らせください(取得できた場合)。
エラーコードDashScopeErrorCode説明
240001ConfigInvalid無効な設定。
240002IllegalParam無効または不足しているパラメーター。
240014StateInvalid現在の状態で許可されない操作。
240051UpdateAudioError音声送信の失敗。
240062NetworkErrorネットワークまたは接続エラー。
240069SocketClosed接続が閉じました。エラーメッセージでローカルのキャンセルかリモート切断かを確認します。
240070AuthFailed認証失敗。
240072HttpSendFailedHTTP リクエストの送信に失敗しました。
240073HttpReceiveFailedHTTP レスポンス本文が空です。
240074HttpResponseInvalidJSON が無効か、必須フィールドがありません。
240075HttpServerErrorサーバーエラー。サーバー側のエラーフィールドを確認。
240080ServerErrorサービスが task-failed を返しました。ServerErrorCode を確認してください。
240091ConnectionTimeout接続タイムアウト。
240092StartTimeoutタスク開始イベントの待機タイムアウト。
240093StopTimeoutタスク完了の待機タイムアウト。