Este tema describe el punto de conexión del servicio, los encabezados de solicitud y el flujo de interacción para acceder al servicio de reconocimiento de voz en tiempo real Qwen-Audio-3.1-ASR-Flash-Message a través de una conexión WebSocket.
Endpoint de servicio
Utilice las siguientes URL de WebSocket con el protocolo wss://:
Singapore
wss://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api-ws/v1/inference
Reemplace {WorkspaceId} con su ID de espacio de trabajo real.
China (Beijing)
wss://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api-ws/v1/inference
Reemplace {WorkspaceId} con su ID de espacio de trabajo real.
ImportanteAlibaba Cloud Model Studio ha lanzado dominios específicos del espacio de trabajo para las regiones China (Pekín) y Singapore. Los nuevos dominios dedicados ofrecen un rendimiento superior y una mayor estabilidad para las solicitudes de inferencia. Recomendamos migrar a los nuevos dominios:
- China (Pekín): de
dashscope.aliyuncs.coma{WorkspaceId}.cn-beijing.maas.aliyuncs.com - Singapur: de
dashscope-intl.aliyuncs.coma{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com
Encabezados de solicitud
Agregue la siguiente información al encabezado de la solicitud:
Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
Authorization | string | Sí | Token de autenticación en el formato |
user-agent | string | No | Identificador de cliente que ayuda al servidor a rastrear el origen de la solicitud. |
X-DashScope-WorkSpace | string | No | ID de espacio de trabajo de Model Studio. |
X-DashScope-DataInspection | string | No | Indica si se debe habilitar la inspección de cumplimiento de datos. Este parámetro se omite o se establece en |
ImportanteLa autorización se verifica durante el protocolo de enlace de WebSocket. Si la clave API no es válida o falta, el protocolo de enlace falla y devuelve un error HTTP 401 o 403.
Flujo de interacción
Para obtener detalles sobre los eventos del cliente y del servidor, consulte Eventos del cliente y Eventos del lado del servidor.
El cliente y el servidor interactúan en el siguiente orden:
- Establecer la conexión: El cliente establece una conexión WebSocket con el servidor.
- Iniciar la tarea: El cliente envía una instrucción run-task para iniciar la tarea y recibe un evento task-started del servidor. Este evento confirma que la tarea ha comenzado y que puede proceder con los pasos siguientes.
- Enviar el flujo de audio: El cliente comienza a enviar audio binario (que debe ser monoaural) y simultáneamente recibe un flujo de eventos result-generated del servidor. Cada evento contiene un resultado de reconocimiento de voz.
- Notificar al servidor para finalizar la tarea: El cliente envía una instrucción finish-task para indicar al servidor que finalice la tarea y continúa recibiendo eventos result-generated del servidor.
- Finalizar la tarea: El cliente recibe un evento task-finished del servidor, lo que indica que la tarea ha terminado.
- Cerrar la conexión: El cliente cierra la conexión WebSocket.