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.
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.Configurer la connexion
Paramètres communs
| Paramètre | Type | Description |
|---|---|---|
ApiKey | string? | Clé API ; utilise DASHSCOPE_API_KEY si omise. |
WorkspaceId | string? | ID d’espace de travail, envoyé dans X-DashScope-WorkSpace. |
Url | string | 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 | wss://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éel | 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 · Reconnaissance vocale en temps réel | wss://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.
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 |
| QwenRealtimeConversation |
| Reconnaissance vocale en temps réel |
| FunAsrSpeechTranscriber |
| Synthèse vocale en temps réel |
| CosyVoiceSpeechSynthesizer |
| Génération audio |
| CosyVoiceSpeechSynthesizer |
| Conversation vocale en temps réel |
| QwenRealtimeConversation |
| Traduction audio et vidéo en temps réel |
| QwenLiveTranslator |
| Reconnaissance vocale en différé (asynchrone) |
| FunAsrFileTranscriber |
| Reconnaissance vocale en différé (requête unique) |
| FunAsrFlashFileTranscriber |
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’erreur | DashScopeErrorCode | Description |
|---|---|---|
| 240001 | ConfigInvalid | Configuration non valide. |
| 240002 | IllegalParam | Paramètre non valide ou manquant. |
| 240014 | StateInvalid | Opération non autorisée dans l’état actuel. |
| 240051 | UpdateAudioError | Échec d’envoi audio. |
| 240062 | NetworkError | Erreur de réseau ou de connexion. |
| 240069 | SocketClosed | Connexion fermée ; le message distingue une annulation locale d’une fermeture distante. |
| 240070 | AuthFailed | Échec d’authentification. |
| 240072 | HttpSendFailed | Échec de l’envoi de la requête HTTP. |
| 240073 | HttpReceiveFailed | Le corps de la réponse HTTP est vide. |
| 240074 | HttpResponseInvalid | JSON non valide ou champ obligatoire absent. |
| 240075 | HttpServerError | Erreur renvoyée par le serveur ; consultez les champs d’erreur serveur. |
| 240080 | ServerError | Le service a renvoyé task-failed. Vérifiez ServerErrorCode. |
| 240091 | ConnectionTimeout | Délai de connexion. |
| 240092 | StartTimeout | Délai d’attente de l’événement de début de tâche. |
| 240093 | StopTimeout | Délai d’attente de la fin de tâche. |