Skip to main content

Qwen-Omni-Realtime Conexión mediante WebSocket

Qwen-Omni-Realtime Conexión mediante WebSocket

Ámbito de aplicación

Este documento está dirigido a Qwen-Omni-Realtime. El modelo del ejemplo es qwen3.8-omni-flash-realtime; las configuraciones de qwen3.5-omni-plus-realtime y qwen3.5-omni-flash-realtime se encuentran en la referencia de eventos. Los parámetros del modelo anterior qwen3-omni-flash-realtime-2025-09-15 se detallan en SDK de Python.
  • Use la API Key y el ID del espacio de trabajo correspondientes a la región y al espacio de trabajo seleccionados.
  • Dominio de Pekín: {WorkspaceId}.cn-beijing.maas.aliyuncs.com; dominio de Singapur: {WorkspaceId}.ap-southeast-1.maas.aliyuncs.com.
  • Las API Keys de larga duración se almacenan en el servidor y no deben colocarse en navegadores ni aplicaciones móviles.

Direcciones y autenticación

Pekín: wss://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api-ws/v1/realtime?model=qwen3.8-omni-flash-realtime Singapur: wss://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api-ws/v1/realtime?model=qwen3.8-omni-flash-realtime qwen3.8-omni-flash-realtime debe usar el dominio específico del espacio de trabajo. Los modelos anteriores pueden seguir usando sus dominios originales: Pekín usa wss://dashscope.aliyuncs.com y Singapur usa wss://dashscope-intl.aliyuncs.com. Para obtener detalles, consulte SDK de Python. Establezca Authorization: Bearer <API_KEY> en el encabezado de la solicitud de handshake de WebSocket. Sustituya el ID del espacio de trabajo y el nombre real del modelo; no coloque API Keys de larga duración en navegadores ni aplicaciones móviles. El encabezado opcional user-agent identifica al cliente. La documentación general de integración de WebSocket también enumera X-DashScope-WorkSpace (ID del espacio de trabajo) y X-DashScope-DataInspection (configuración de verificación de cumplimiento de datos), que se usan según los requisitos del modelo. Para obtener instrucciones sobre la generación de API Keys temporales y sus permisos, consulte Generar una API Key temporal.

Configuración de la sesión

Envíe session.update después de establecer la conexión y recibir session.created. Envíe la entrada solo después de recibir la confirmación session.updated; maneje los errores mediante eventos error. Los siguientes ejemplos corresponden a qwen3.8-omni-flash-realtime; las demás versiones deben usar las configuraciones de sus respectivas referencias de eventos sin mezclar los niveles de campos. 
{
  "type": "session.update",
  "session": {
    "modalities": [
      "text",
      "audio"
    ],
    "voice": "Tina",
    "turn_detection": {
      "type": "server_vad"
    }
  }
}

Entrada, resultados y finalización

El audio se envía mediante input_audio_buffer.append; los formatos de entrada, las condiciones de envío y los límites de entrada de imágenes se describen en Eventos del cliente. Procese los resultados, estados y errores según Eventos del servidor; no interprete el establecimiento de la conexión como la finalización de la solicitud de negocio. La secuencia de turnos automáticos, el modo Manual, Function Calling y MCP se describe en Flujo de interacción. Después de recibir los resultados necesarios, cierre la conexión de WebSocket.

Manejo de errores

Si falla el handshake, verifique el dominio, la región, el espacio de trabajo, la API Key, el nombre del modelo, su estado de activación y sus permisos. Una vez establecida la conexión, localice el problema según el evento error y consulte Códigos de error. Conserve el ID del evento para el diagnóstico; no suponga que no existe compatibilidad con el protocolo solo porque no haya respuesta.

SDK y referencias