Tous les produits
Search
Centre de documentation

Alibaba Cloud Model Studio:Intégration du SDK

Dernière mise à jour :Nov 20, 2026

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ètreTypeDescription

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.

FonctionURL

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.

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

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’erreurDashScopeErrorCodeDescription

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.