Skip to main content

Integración del SDK

Instale y configure el SDK de C# de Model Studio, elija el cliente para su familia de modelos y gestione la finalización de tareas, los tiempos de espera y los errores.

Primeros pasos

Requisitos previos

  • Instale el SDK de .NET 8 o .NET 10.
  • Obtener una API key y configure la variable de entorno DASHSCOPE_API_KEY.
Guarde las claves de API de larga duración en el servidor. No las incluya en aplicaciones de escritorio, móviles o de navegador que distribuya. Para protegerlas, consulte Proteger la clave de API.

Instalar el SDK

Descargue y descomprima Bailian.DashScope-1.1.1.zip. El paquete NuGet se llama Bailian.DashScope, el ensamblado es DashScope.dll y el espacio de nombres raíz es DashScope. No hay dependencias nativas ni dependencias transitivas de NuGet.
  • Origen NuGet local (recomendado)
  • Hacer referencia directa a la DLL
Use el directorio packages/ extraído como origen NuGet local.
Los ejemplos usan .NET 8. Para .NET 10, sustituya net8.0 por net10.0 en los comandos y las rutas.
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"
Para verificar los archivos, ejecute este comando en el directorio del paquete extraído:
shasum -a 256 -c SHA256SUMS.txt

Configurar la conexión

Parámetros comunes

ParámetroTipoDescripción
ApiKeystring?API key; si se omite, lee DASHSCOPE_API_KEY.
WorkspaceIdstring?ID del espacio de trabajo, enviado en X-DashScope-WorkSpace.
UrlstringURL completa del endpoint.

Configurar la URL del endpoint

WorkspaceId agrega el encabezado del espacio de trabajo, sin cambiar el endpoint. Configure la dirección completa en Url. Para la interacción multimodal, la conversación por voz y la traducción de audio y video en tiempo real, el SDK agrega el nombre del modelo a la URL de WebSocket en el parámetro de consulta model. En el reconocimiento y la síntesis de voz y en la generación de audio, lo envía en el cuerpo de la solicitud.
FunciónURL
Qwen-Audio / Fun-ASR-Realtime / CosyVoice / Qwen-Audio-TTS-Nextwss://WorkspaceId.ap-southeast-1.maas.aliyuncs.com/api-ws/v1/inference
Multimodal en tiempo real / Conversación por voz en tiempo real / Traducción de audio y video en tiempo realwss://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 · Reconocimiento de voz en tiempo realwss://WorkspaceId.cn-beijing.maas.aliyuncs.com/api-ws/v1/inference
Paraformer · Reconocimiento de voz no en tiempo realhttps://WorkspaceId.cn-beijing.maas.aliyuncs.com/api/v1/services/audio/asr/transcription

Verificar la instalación y la configuración

Ejecute los comandos en el directorio demo/DashScope.Cli/ extraído. El ejemplo convierte el audio a PCM mono de 16 kHz para el reconocimiento en tiempo real. Sustituya WorkspaceId por el ID del espacio de trabajo de su clave de 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"

Funciones y modelos compatibles

Este SDK administrado de .NET envía audio o texto y recibe resultados. No incluye captura de audio, códecs, detección de palabras de activación, VAD local ni cancelación de eco.
TipoModelos compatiblesCliente de C#
Multimodal en tiempo real
  • 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
Reconocimiento de voz en tiempo real
  • 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
Síntesis de voz en tiempo real
  • 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
Generación de audio
  • Qwen-Audio-TTS-Next: qwen-audio-3.1-tts-next
CosyVoiceSpeechSynthesizer
Conversación por voz en tiempo real
  • 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
Traducción de audio y video en tiempo real
  • Qwen-LiveTranslate-Realtime: qwen3.5-livetranslate-flash-realtime, qwen3.5-livetranslate-flash-realtime-2026-05-19, qwen3.8-livetranslate-flash-realtime
QwenLiveTranslator
Reconocimiento de voz no en tiempo real (asíncrono)
  • 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
Reconocimiento de voz no en tiempo real (una solicitud)
  • 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
Ejecute el siguiente comando en el directorio del proyecto de demostración compilado para ver los ID de modelo incluidos en la demostración.
dotnet bin/Debug/net8.0/DashScope.Cli.dll models --names-only

Consideraciones de uso

Compatibilidad de modelos y voces

Si varias familias de modelos usan la misma clase de cliente, configure Model explícitamente. De lo contrario, el SDK usará el modelo predeterminado de la clase. Los métodos ModelRouting del SDK identifican algunas familias de modelos por su nombre. Consulte la tabla de modelos compatibles de esta página para elegir el cliente. Al cambiar de modelo de síntesis, elija una voz compatible con el nuevo modelo. Qwen-Audio-TTS y CosyVoice comparten cliente, pero no la lista de voces. Para elegir una voz, consulte Lista de voces de Qwen-Audio-TTS y Lista de voces de CosyVoice.

Finalizar o cancelar una llamada

  • Reconocimiento de voz en tiempo real
  • Conversación por voz en tiempo real
  • Reconocimiento de voz no en tiempo real
En reconocimiento en tiempo real y síntesis dúplex, espere a StopAsync() para recibir los resultados finales. Las llamadas repetidas no generan otro evento de finalización. CancelAsync() cierra la conexión sin esperar y puede llamarse varias veces.Si cancela mientras StopAsync() espera, la llamada pendiente falla con 240069. Llamar a StopAsync() después de cancelar genera 240014. Liberar una tarea sin finalizar notifica 240069 mediante Failed.

Códigos de error

Si falla una llamada, al esperar el resultado se puede producir una excepción DashScopeException. En el reconocimiento y la síntesis de voz en tiempo real, el evento Failed también notifica los errores de conexión. Use ServerErrorCode y ServerErrorMessage para diagnosticar errores del servidor. Si se comunica con soporte técnico, proporcione el TaskId y el RequestId devueltos por la llamada, si están disponibles.
Código de errorDashScopeErrorCodeDescripción
240001ConfigInvalidConfiguración no válida.
240002IllegalParamParámetro no válido o ausente.
240014StateInvalidOperación no permitida en el estado actual.
240051UpdateAudioErrorError al enviar audio.
240062NetworkErrorError de red o conexión.
240069SocketClosedConexión cerrada; consulte el mensaje para distinguir una cancelación local de un cierre remoto.
240070AuthFailedError de autenticación.
240072HttpSendFailedError al enviar la solicitud HTTP.
240073HttpReceiveFailedEl cuerpo de la respuesta HTTP está vacío.
240074HttpResponseInvalidJSON no válido o falta un campo obligatorio.
240075HttpServerErrorEl servidor devolvió un error; revise los campos de error del servidor.
240080ServerErrorEl servicio devolvió task-failed. Consulte ServerErrorCode.
240091ConnectionTimeoutTiempo de espera de conexión.
240092StartTimeoutTiempo de espera del evento de inicio de tarea.
240093StopTimeoutTiempo de espera de finalización de tarea.