Skip to main content

Intégration du SDK

Installez et configurez le SDK C# de Model Studio, choisissez le client adapté à votre famille de modèles et gérez la fin des tâches, les délais d’attente et les erreurs.

Premiers pas

Prérequis

  • Installez le SDK .NET 8 ou .NET 10.
  • Obtenir une clé API, puis définissez la variable d’environnement DASHSCOPE_API_KEY.
Conservez les clés API de longue durée sur le serveur. Ne les intégrez pas aux applications de bureau, mobiles ou web que vous distribuez. Pour les protéger, consultez Protéger votre clé API.

Installer le SDK

Téléchargez et décompressez Bailian.DashScope-1.1.1.zip. Le paquet NuGet s’appelle Bailian.DashScope, l’assembly est DashScope.dll et l’espace de noms racine est DashScope. Aucune bibliothèque native ni dépendance NuGet transitive n’est nécessaire.
  • Source NuGet locale (recommandée)
  • Référencer directement la DLL
Utilisez le répertoire packages/ extrait comme source NuGet locale.
Les exemples utilisent .NET 8. Pour .NET 10, remplacez net8.0 par net10.0 dans les commandes et les chemins.
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"
Pour vérifier les fichiers, exécutez cette commande depuis le répertoire du paquet extrait :
shasum -a 256 -c SHA256SUMS.txt

Configurer la connexion

Paramètres communs

ParamètreTypeDescription
ApiKeystring?Clé API ; utilise DASHSCOPE_API_KEY si omise.
WorkspaceIdstring?ID d’espace de travail, envoyé dans X-DashScope-WorkSpace.
UrlstringURL complète du point de terminaison.

Configurer l’URL du point de terminaison

WorkspaceId ajoute l’en-tête de l’espace de travail sans modifier le point de terminaison. Définissez l’adresse complète dans Url. Pour l’interaction multimodale, la conversation vocale et la traduction audio et vidéo en temps réel, le SDK ajoute le nom du modèle à l’URL WebSocket dans le paramètre de requête model. Pour la reconnaissance vocale, la synthèse vocale et la génération audio, il l’envoie dans le corps de la requête.
FonctionURL
Qwen-Audio / Fun-ASR-Realtime / CosyVoice / Qwen-Audio-TTS-Nextwss://WorkspaceId.ap-southeast-1.maas.aliyuncs.com/api-ws/v1/inference
Multimodal en temps réel / Conversation vocale en temps réel / Traduction audio et vidéo en temps réelwss://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 · Reconnaissance vocale en temps réelwss://WorkspaceId.cn-beijing.maas.aliyuncs.com/api-ws/v1/inference
Paraformer · Reconnaissance vocale en différéhttps://WorkspaceId.cn-beijing.maas.aliyuncs.com/api/v1/services/audio/asr/transcription

Vérifier l’installation et la configuration

Exécutez les commandes dans le répertoire demo/DashScope.Cli/ extrait. L’exemple convertit l’audio en PCM mono à 16 kHz et lance la reconnaissance en temps réel. Remplacez WorkspaceId par l’identifiant de l’espace de travail de votre clé API.
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"

Fonctionnalités et modèles pris en charge

Ce SDK .NET en code managé envoie de l’audio ou du texte et reçoit les résultats. Il ne fournit ni capture audio, ni codec, ni détection de mot d’activation, de parole (VAD) ou d’écho côté appareil.
TypeModèles pris en chargeClient C#
Multimodal en temps réel
  • 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
Reconnaissance vocale en temps réel
  • 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
Synthèse vocale en temps réel
  • 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
Génération audio
  • Qwen-Audio-TTS-Next : qwen-audio-3.1-tts-next
CosyVoiceSpeechSynthesizer
Conversation vocale en temps réel
  • 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
Traduction audio et vidéo en temps réel
  • Qwen-LiveTranslate-Realtime : qwen3.5-livetranslate-flash-realtime, qwen3.5-livetranslate-flash-realtime-2026-05-19, qwen3.8-livetranslate-flash-realtime
QwenLiveTranslator
Reconnaissance vocale en différé (asynchrone)
  • 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
Reconnaissance vocale en différé (requête unique)
  • 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
Dans le répertoire du projet de démonstration compilé, exécutez la commande suivante pour afficher les identifiants de modèle inclus dans la démonstration.
dotnet bin/Debug/net8.0/DashScope.Cli.dll models --names-only

Points à prendre en compte

Compatibilité des modèles et des voix

Si plusieurs familles de modèles utilisent la même classe de client, définissez explicitement Model. Sinon, le SDK utilise le modèle par défaut de la classe. Les méthodes ModelRouting du SDK identifient certaines familles de modèles par leur nom. Consultez le tableau des modèles pris en charge sur cette page pour choisir le client. Si vous changez de modèle de synthèse, choisissez une voix compatible avec le nouveau modèle. Qwen-Audio-TTS et CosyVoice utilisent le même client, mais pas la même liste de voix. Pour choisir une voix, consultez Liste des voix Qwen-Audio-TTS et liste des voix CosyVoice.

Terminer ou annuler un appel

  • Reconnaissance vocale en temps réel
  • Conversation vocale en temps réel
  • Reconnaissance vocale en différé
Pour la reconnaissance en temps réel et la synthèse duplex, attendez StopAsync() pour obtenir les derniers résultats. Un deuxième appel ne redéclenche pas l’événement de fin. CancelAsync() ferme immédiatement la connexion et peut être appelé plusieurs fois.Si vous annulez pendant que StopAsync() attend, cet appel échoue avec 240069. Appeler StopAsync() après l’annulation produit 240014. Libérer une tâche non terminée signale 240069 via Failed.

Codes d’erreur

En cas d’échec, l’attente du résultat d’un appel peut lever DashScopeException. Pour la reconnaissance et la synthèse vocales en temps réel, l’événement Failed signale également les erreurs de connexion. Utilisez ServerErrorCode et ServerErrorMessage pour diagnostiquer les erreurs du serveur. Si vous contactez le support technique, communiquez le TaskId et le RequestId renvoyés par l’appel, s’ils sont disponibles.
Code d’erreurDashScopeErrorCodeDescription
240001ConfigInvalidConfiguration non valide.
240002IllegalParamParamètre non valide ou manquant.
240014StateInvalidOpération non autorisée dans l’état actuel.
240051UpdateAudioErrorÉchec d’envoi audio.
240062NetworkErrorErreur de réseau ou de connexion.
240069SocketClosedConnexion fermée ; le message distingue une annulation locale d’une fermeture distante.
240070AuthFailedÉchec d’authentification.
240072HttpSendFailedÉchec de l’envoi de la requête HTTP.
240073HttpReceiveFailedLe corps de la réponse HTTP est vide.
240074HttpResponseInvalidJSON non valide ou champ obligatoire absent.
240075HttpServerErrorErreur renvoyée par le serveur ; consultez les champs d’erreur serveur.
240080ServerErrorLe service a renvoyé task-failed. Vérifiez ServerErrorCode.
240091ConnectionTimeoutDélai de connexion.
240092StartTimeoutDélai d’attente de l’événement de début de tâche.
240093StopTimeoutDélai d’attente de la fin de tâche.