Skip to main content

Eventos do servidor Qwen-Audio-ASR-Message

Referência de eventos do servidor Qwen-Audio-ASR-Message: início da tarefa, resultados, conclusão, falha e solicitações correspondentes.

Fluxo de eventos

  1. Envie run-task. Aguarde task-started antes de enviar áudio.
  2. Continue enviando áudio enquanto recebe eventos result-generated.
  3. Durante a tarefa, use continue-task para atualizar o contexto da conversa. Continue enviando o áudio pelo canal de áudio.
  4. Após enviar todo o áudio, envie finish-task e receba os resultados até chegar task-finished. Uma tarefa com falha retorna task-failed.
O áudio não é enviado em run-task: o WebSocket usa quadros binários e o AOQ usa uma Audio Track. Para conexão, autenticação e transporte de áudio, consulte a API WebSocket ou o acesso AOQ.

task-started

Indica que a tarefa foi iniciada com sucesso e que o cliente pode começar a enviar áudio.
Aguarde task-started antes de enviar áudio. run-task apenas inicia e configura a tarefa; ele não contém dados de áudio.
headerobject
task_idstring
ID da tarefa gerado pelo cliente, no formato UUID.
eventstring
Tipo de evento. O valor é sempre task-started.
attributesobject
Atributos adicionais, geralmente vazios.
payloadobject
O valor é sempre {}.
Solicitação:
{
  "header": {
    "action": "run-task",
    "task_id": "ab4f7812-2d71-4e3d-93d3-b68ab80d3755",
    "streaming": "duplex"
  },
  "payload": {
    "input": {},
    "task_group": "audio",
    "task": "asr",
    "function": "recognition",
    "model": "qwen-audio-3.1-asr-flash-message",
    "parameters": {
      "format": "pcm",
      "sample_rate": 16000
    }
  }
}
Resposta:
{
  "header": {
    "task_id": "ab4f7812-2d71-4e3d-93d3-b68ab80d3755",
    "task_uuid": "852196dba9d14bea9cf0d6e04ff0b027",
    "event": "task-started",
    "attributes": {}
  },
  "payload": {}
}

result-generated

Retorna resultados de reconhecimento, incluindo início de frase, resultados intermediários, resultados finais de frase e heartbeats. Os resultados intermediários são desativados por padrão; defina intermediate_result_enabled=true para ativá-los.
sentence_end=true indica o fim de uma frase, não da tarefa. Resultados de heartbeat (heartbeat=true) podem ser ignorados. A tarefa termina quando task-finished é recebido.
headerobject
task_idstring
ID da tarefa gerado pelo cliente, no formato UUID.
eventstring
Tipo de evento. O valor é sempre result-generated.
payloadobject
outputobject
sentenceobject
sentence_idinteger
Identificador sequencial da frase. Nos resultados normais, sentence_id aumenta a partir de 1. Quando heartbeat é true (pacote heartbeat), sentence_id é sempre 0.
begin_timeinteger
Tempo de início da frase, em milissegundos.
end_timeinteger
Tempo de fim da frase, em milissegundos.Pode ser null em resultados intermediários ou heartbeats.
textstring
Texto reconhecido.
O texto intermediário pode mudar à medida que o reconhecimento avança. Atualize o texto exibido para o mesmo sentence_id, em vez de concatenar os textos intermediários.
sentence_beginboolean
O valor true indica o início de uma frase. O campo text pode estar vazio nesse momento.
sentence_endboolean
Indica se a frase terminou (true: resultado final, false: resultado intermediário).
heartbeatboolean
Se o valor for true, o resultado é um pacote heartbeat e pode ser ignorado.
wordsarray[object]
Informações de timestamp no nível de palavra.
begin_timeinteger
Tempo de início da palavra, em milissegundos.
end_timeinteger
Tempo de fim da palavra, em milissegundos.
textstring
Texto reconhecido.
punctuationstring
Sinal de pontuação.
usageobject
Uso acumulado da tarefa atual até este evento.
usage contém o uso acumulado da tarefa atual. Não some os valores de usage dos eventos. Após a conclusão, use o total acumulado final em task-finished.
durationinteger
Duração acumulada do áudio em segundos, mantida por compatibilidade.
input_tokensinteger
Número acumulado de tokens de entrada.
output_tokensinteger
Número acumulado de tokens de saída.
total_tokensinteger
Número total acumulado de tokens: soma de input_tokens e output_tokens.
  • Início de frase
  • Resultado intermediário
  • Resultado final de frase
Solicitação:
{
  "header": {
    "action": "run-task",
    "task_id": "ab4f7812-2d71-4e3d-93d3-b68ab80d3755",
    "streaming": "duplex"
  },
  "payload": {
    "input": {},
    "task_group": "audio",
    "task": "asr",
    "function": "recognition",
    "model": "qwen-audio-3.1-asr-flash-message",
    "parameters": {
      "format": "pcm",
      "sample_rate": 16000
    }
  }
}
Resposta:
{
  "header": {
    "task_id": "ab4f7812-2d71-4e3d-93d3-b68ab80d3755",
    "event": "result-generated",
    "attributes": {}
  },
  "payload": {
    "output": {
      "sentence": {
        "sentence_id": 1,
        "begin_time": 0,
        "end_time": null,
        "text": "",
        "sentence_end": false,
        "sentence_begin": true,
        "words": []
      }
    }
  }
}

task-finished

O processamento da tarefa foi concluído e todos os resultados de reconhecimento foram retornados. O cliente pode fechar a conexão ou reutilizá-la para iniciar uma nova tarefa.
headerobject
task_idstring
ID da tarefa gerado pelo cliente, no formato UUID.
eventstring
Tipo de evento. O valor é sempre task-finished.
attributesobject
Atributos adicionais, geralmente vazios.
payloadobject
Contém output (objeto vazio) e usage (uso acumulado final da tarefa). Os campos de usage têm as mesmas definições de result-generated.
Solicitação:
{
  "header": {
    "action": "finish-task",
    "task_id": "ab4f7812-2d71-4e3d-93d3-b68ab80d3755",
    "streaming": "duplex"
  },
  "payload": {
    "input": {}
  }
}
Resposta:
{
  "header": {
    "task_id": "ab4f7812-2d71-4e3d-93d3-b68ab80d3755",
    "event": "task-finished",
    "attributes": {}
  },
  "payload": {
    "output": {},
    "usage": {
      "duration": 4,
      "input_tokens": 51,
      "output_tokens": 13,
      "total_tokens": 64
    }
  }
}

task-failed

Indica que a tarefa falhou. Verifique error_code e error_message para identificar a causa. Após a falha, a conexão WebSocket é fechada e não pode ser reutilizada.
headerobject
task_idstring
ID da tarefa gerado pelo cliente, no formato UUID.
eventstring
Tipo de evento. O valor é sempre task-failed.
error_codestring
Descrição do tipo de erro.
error_messagestring
Causa específica do erro.
attributesobject
Atributos adicionais, geralmente vazios.
payloadobject
O valor é sempre {}.
Esta solicitação usa um formato de áudio não compatível para demonstrar task-failed. O código e a mensagem de erro dependem da causa da falha.
Solicitação:
{
  "header": {
    "action": "run-task",
    "task_id": "5927b897-6890-45cd-9b85-bc58bdaaadfb",
    "streaming": "duplex"
  },
  "payload": {
    "input": {},
    "task_group": "audio",
    "task": "asr",
    "function": "recognition",
    "model": "qwen-audio-3.1-asr-flash-message",
    "parameters": {
      "format": "invalid-format",
      "sample_rate": 16000
    }
  }
}
Resposta:
{
  "header": {
    "task_id": "5927b897-6890-45cd-9b85-bc58bdaaadfb",
    "event": "task-failed",
    "error_code": "UNSUPPORTED_FORMAT",
    "error_message": "UNSUPPORTED_FORMAT"
  },
  "payload": {}
}