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
- Envie run-task. Aguarde task-started antes de enviar áudio.
- Continue enviando áudio enquanto recebe eventos result-generated.
- Durante a tarefa, use continue-task para atualizar o contexto da conversa. Continue enviando o áudio pelo canal de áudio.
- Após enviar todo o áudio, envie finish-task e receba os resultados até chegar task-finished. Uma tarefa com falha retorna task-failed.
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.
headerobjecttask_idstringID da tarefa gerado pelo cliente, no formato UUID.
eventstringTipo de evento. O valor é sempre
task-started.attributesobjectAtributos adicionais, geralmente vazios.
payloadobjectO valor é sempre
{}.Solicitação:
Resposta:
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.
headerobjecttask_idstringID da tarefa gerado pelo cliente, no formato UUID.
eventstringTipo de evento. O valor é sempre
result-generated.payloadobjectoutputobjectsentenceobjectsentence_idintegerIdentificador sequencial da frase. Nos resultados normais,
sentence_id aumenta a partir de 1. Quando heartbeat é true (pacote heartbeat), sentence_id é sempre 0.begin_timeintegerTempo de início da frase, em milissegundos.
end_timeintegerTempo de fim da frase, em milissegundos.Pode ser
null em resultados intermediários ou heartbeats.textstringTexto 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_beginbooleanO valor
true indica o início de uma frase. O campo text pode estar vazio nesse momento.sentence_endbooleanIndica se a frase terminou (
true: resultado final, false: resultado intermediário).heartbeatbooleanSe 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_timeintegerTempo de início da palavra, em milissegundos.
end_timeintegerTempo de fim da palavra, em milissegundos.
textstringTexto reconhecido.
punctuationstringSinal de pontuação.
usageobjectUso 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.durationintegerDuração acumulada do áudio em segundos, mantida por compatibilidade.
input_tokensintegerNúmero acumulado de tokens de entrada.
output_tokensintegerNúmero acumulado de tokens de saída.
total_tokensintegerNú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:
Resposta:
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.
headerobjecttask_idstringID da tarefa gerado pelo cliente, no formato UUID.
eventstringTipo de evento. O valor é sempre
task-finished.attributesobjectAtributos adicionais, geralmente vazios.
payloadobjectConté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:
Resposta:
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.
headerobjecttask_idstringID da tarefa gerado pelo cliente, no formato UUID.
eventstringTipo de evento. O valor é sempre
task-failed.error_codestringDescrição do tipo de erro.
error_messagestringCausa específica do erro.
attributesobjectAtributos adicionais, geralmente vazios.
payloadobjectO 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:
Resposta: