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.
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.Configurar la conexión
Parámetros comunes
| Parámetro | Tipo | Descripción |
|---|---|---|
ApiKey | string? | API key; si se omite, lee DASHSCOPE_API_KEY. |
WorkspaceId | string? | ID del espacio de trabajo, enviado en X-DashScope-WorkSpace. |
Url | string | URL 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ón | 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 tiempo real / Conversación por voz en tiempo real / Traducción de audio y video en tiempo real | 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 · Reconocimiento de voz en tiempo real | wss://WorkspaceId.cn-beijing.maas.aliyuncs.com/api-ws/v1/inference |
| Paraformer · Reconocimiento de voz no en tiempo real | https://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.
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.
| Tipo | Modelos compatibles | Cliente de C# |
|---|---|---|
| Multimodal en tiempo real |
| QwenRealtimeConversation |
| Reconocimiento de voz en tiempo real |
| FunAsrSpeechTranscriber |
| Síntesis de voz en tiempo real |
| CosyVoiceSpeechSynthesizer |
| Generación de audio |
| CosyVoiceSpeechSynthesizer |
| Conversación por voz en tiempo real |
| QwenRealtimeConversation |
| Traducción de audio y video en tiempo real |
| QwenLiveTranslator |
| Reconocimiento de voz no en tiempo real (asíncrono) |
| FunAsrFileTranscriber |
| Reconocimiento de voz no en tiempo real (una solicitud) |
| FunAsrFlashFileTranscriber |
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 error | DashScopeErrorCode | Descripción |
|---|---|---|
| 240001 | ConfigInvalid | Configuración no válida. |
| 240002 | IllegalParam | Parámetro no válido o ausente. |
| 240014 | StateInvalid | Operación no permitida en el estado actual. |
| 240051 | UpdateAudioError | Error al enviar audio. |
| 240062 | NetworkError | Error de red o conexión. |
| 240069 | SocketClosed | Conexión cerrada; consulte el mensaje para distinguir una cancelación local de un cierre remoto. |
| 240070 | AuthFailed | Error de autenticación. |
| 240072 | HttpSendFailed | Error al enviar la solicitud HTTP. |
| 240073 | HttpReceiveFailed | El cuerpo de la respuesta HTTP está vacío. |
| 240074 | HttpResponseInvalid | JSON no válido o falta un campo obligatorio. |
| 240075 | HttpServerError | El servidor devolvió un error; revise los campos de error del servidor. |
| 240080 | ServerError | El servicio devolvió task-failed. Consulte ServerErrorCode. |
| 240091 | ConnectionTimeout | Tiempo de espera de conexión. |
| 240092 | StartTimeout | Tiempo de espera del evento de inicio de tarea. |
| 240093 | StopTimeout | Tiempo de espera de finalización de tarea. |