Skip to main content

Qwen-Omni-Realtime Acesso por WebSocket

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

WebSocketwss://WorkspaceId.ap-southeast-1.maas.aliyuncs.com/api-ws/v1/realtime?model=qwen3.8-omni-flash-realtime

qwen3.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.
{
  "type": "session.update",
  "session": {
    "modalities": [
      "text",
      "audio"
    ],
    "voice": "Tina",
    "turn_detection": {
      "type": "server_vad"
    }
  }
}

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.

SDKs e referências