Qwen-Omni-Realtime Acesso por WebSocket
Escopo de aplicação
Este documento se aplica ao Qwen-Omni-Realtime. O exemplo usa qwen3.8-omni-flash-realtime; as configurações de qwen3.5-omni-plus-realtime e qwen3.5-omni-flash-realtime estão na referência de eventos. Para os parâmetros do modelo legado qwen3-omni-flash-realtime-2025-09-15, consulte SDK para Python.
- Use a chave de API e o ID do workspace correspondentes à região e ao workspace selecionados.
- domínio de Singapura:
{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com. - Armazene as chaves de API permanentes no servidor. Não as inclua em navegadores nem em aplicações móveis.
Endereços e autenticação
WebSocket
wss://WorkspaceId.ap-southeast-1.maas.aliyuncs.com/api-ws/v1/realtime?model=qwen3.8-omni-flash-realtimeqwen3.8-omni-flash-realtime exige o domínio específico do workspace. Os modelos anteriores podem continuar usando os domínios originais: wss://dashscope.aliyuncs.com em Pequim e wss://dashscope-intl.aliyuncs.com em Singapura. Para mais detalhes, consulte SDK para Python.
Defina Authorization: Bearer <API_KEY> no cabeçalho da solicitação de handshake do WebSocket. Substitua o ID do workspace e o nome real do modelo. Não inclua chaves de API permanentes em navegadores nem em aplicações móveis.
O cabeçalho opcional user-agent identifica o cliente. A documentação geral de integração WebSocket também lista X-DashScope-WorkSpace (ID do workspace) e X-DashScope-DataInspection (configuração de inspeção de conformidade dos dados). Use esses cabeçalhos conforme os requisitos do modelo.
Para gerar chaves de API temporárias e consultar suas permissões, consulte Gerar uma chave de API temporária.
Configuração da sessão
Depois de estabelecer a conexão e receber session.created, envie session.update. Envie a entrada somente após receber a confirmação session.updated; trate os erros pelos eventos error.
Os exemplos a seguir se aplicam a qwen3.8-omni-flash-realtime. Outras versões devem usar as configurações das respectivas referências de eventos, sem misturar os níveis dos campos.
Entrada, resultados e encerramento
O áudio é enviado por input_audio_buffer.append. Os formatos de entrada, as condições de envio e os limites de entrada de imagem estão em Eventos do cliente. Processe os resultados, os estados e os erros em Eventos do servidor. O estabelecimento da conexão não significa que a solicitação da aplicação foi concluída.
A sequência dos turnos automáticos, do modo Manual, do Function Calling e do MCP está em Fluxo de interação. Após receber os resultados necessários, feche a conexão WebSocket.
Tratamento de erros
Se o handshake falhar, verifique o domínio, a região, o workspace, a chave de API, o nome do modelo, seu estado de ativação e as permissões. Depois de estabelecer a conexão, localize o problema pelo evento error e consulte Códigos de erro. Guarde o ID do evento para facilitar a investigação. A ausência de resposta não basta para concluir que o protocolo não é compatível.