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 Fun-ASR-Realtime a través de una conexión WebSocket.
Endpoint de servicio
La URL de WebSocket es fija:
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 Bearer <your_api_key>. Reemplace <your_api_key> con su clave API real. |
user-agent | string | No | Identificador del cliente que ayuda al servidor a rastrear el origen de la solicitud. |
X-DashScope-WorkSpace | string | No | ID del espacio de trabajo de Model Studio workspace ID. |
X-DashScope-DataInspection | string | No | Si se debe habilitar la inspección de cumplimiento de datos. Este parámetro se omite o se establece en enable de forma predeterminada. No habilite este parámetro a menos que sea necesario. |
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.