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.
AvertissementConservez 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)
Utilisez le répertoire packages/ extrait comme source NuGet locale.
RemarqueLes 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"
Référencer directement la DLL
Pour une référence directe à la DLL, choisissez sdk/net8.0/DashScope.dll ou sdk/net10.0/DashScope.dll selon le framework cible. Placez DashScope.xml à côté de la DLL pour la documentation dans l’IDE.
<ItemGroup>
<Reference Include="DashScope">
<HintPath>/path/to/Bailian.DashScope-1.1.1/sdk/net8.0/DashScope.dll</HintPath>
</Reference>
</ItemGroup>
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ètre | Type | Description |
|---|---|---|
|
| Clé API ; utilise |
|
| ID d’espace de travail, envoyé dans |
|
| URL 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.
| Fonction | URL |
|---|---|
Qwen-Audio / Fun-ASR-Realtime / CosyVoice / Qwen-Audio-TTS-Next |
|
Multimodal en temps réel / Conversation vocale en temps réel / Traduction audio et vidéo en temps réel |
|
Qwen-Audio-ASR-Filetrans / Fun-ASR |
|
Qwen-Audio-ASR / Fun-ASR-Flash |
|
Paraformer · Reconnaissance vocale en temps réel |
|
Paraformer · Reconnaissance vocale en différé |
|
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.
| Type | Modèles pris en charge | Client C# |
|---|---|---|
Multimodal en temps réel |
|
|
Reconnaissance vocale en temps réel |
|
|
Synthèse vocale en temps réel |
|
|
Génération audio |
|
|
Conversation vocale en temps réel |
|
|
Traduction audio et vidéo en temps réel |
|
|
Reconnaissance vocale en différé (asynchrone) |
|
|
Reconnaissance vocale en différé (requête unique) |
|
|
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
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.
Conversation vocale en temps réel
Pour une conversation ou une traduction, appelez FinishAsync() après la dernière réponse. Le client choisit FinishMode selon le modèle.
Reconnaissance vocale en différé
Annuler l’attente locale n’annule pas la transcription distante : utilisez CancelTaskAsync(taskId) lorsque la tâche est encore en attente.
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’erreur | DashScopeErrorCode | Description |
|---|---|---|
240001 |
| Configuration non valide. |
240002 |
| Paramètre non valide ou manquant. |
240014 |
| Opération non autorisée dans l’état actuel. |
240051 |
| Échec d’envoi audio. |
240062 |
| Erreur de réseau ou de connexion. |
240069 |
| Connexion fermée ; le message distingue une annulation locale d’une fermeture distante. |
240070 |
| Échec d’authentification. |
240072 |
| Échec de l’envoi de la requête HTTP. |
240073 |
| Le corps de la réponse HTTP est vide. |
240074 |
| JSON non valide ou champ obligatoire absent. |
240075 |
| Erreur renvoyée par le serveur ; consultez les champs d’erreur serveur. |
240080 |
| Le service a renvoyé |
240091 |
| Délai de connexion. |
240092 |
| Délai d’attente de l’événement de début de tâche. |
240093 |
| Délai d’attente de la fin de tâche. |