Referência de eventos do servidor Qwen-Audio-ASR-Streaming: 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.
- 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 (formato UUID).
eventstringTipo do evento. Sempre
task-started.attributesobjectAtributos adicionais. Geralmente vazio.
payloadobjectSempre
{}.Solicitação:
Resposta:
result-generated
Retorna resultados de reconhecimento, incluindo início de frase, resultados intermediários, resultados finais de frase e heartbeats.
headerobjecttask_idstringID da tarefa gerado pelo cliente (formato UUID).
eventstringTipo do evento. Sempre
result-generated.payloadobjectoutputobjectsentenceobjectsentence_idintegerIdentificador sequencial da frase. Em resultados normais,
sentence_id incrementa a partir de 1. Em pacotes de heartbeat (heartbeat=true), sentence_id é sempre 0.begin_timeintegerHorário de início da frase, em milissegundos.
end_timeinteger | nullHorário de término da frase, em milissegundos. Pode ser
null em resultados intermediários ou heartbeats.textstringTexto reconhecido.
sentence_beginbooleanIndica o início de uma frase.
sentence_endbooleanIndica se a frase terminou (
true = resultado final; false = resultado intermediário).heartbeatbooleanSe
true, o resultado é um pacote de heartbeat e pode ser ignorado.wordsarray[object]Carimbos de data/hora no nível da palavra.
begin_timeintegerHorário de início da palavra, em milissegundos.
end_timeintegerHorário de término da palavra, em milissegundos.
textstringTexto reconhecido.
punctuationstringSinal de pontuação.
usageobjectUso acumulado da tarefa atual.
usage contém o uso acumulado da tarefa atual e pode estar ausente em alguns resultados intermediários. Não some os valores de usage entre eventos. qwen-audio-3.0-asr-flash-streaming é cobrado por duração e qwen-audio-3.1-asr-flash-streaming por tokens. Consulte a aplicabilidade na descrição de cada campo.durationintegerDuração acumulada do áudio, em segundos.
Usado para o faturamento de qwen-audio-3.0-asr-flash-streaming.
input_tokensintegerNúmero acumulado de tokens de entrada.
Aplica-se a qwen-audio-3.1-asr-flash-streaming.
output_tokensintegerNúmero acumulado de tokens de saída.
Aplica-se a qwen-audio-3.1-asr-flash-streaming.
total_tokensintegerTotal acumulado de tokens, igual à soma dos tokens de entrada e saída.
Aplica-se a qwen-audio-3.1-asr-flash-streaming.
- Início de frase
- Resultado intermediário
- Resultado final de frase
- Heartbeat
Após receber
task-started, envie áudio. O exemplo abaixo é um evento result-generated retornado em seguida pelo servidor. O áudio é enviado por quadros binários WebSocket ou pela Audio Track AOQ.Solicitação:
Resposta:
task-finished
Indica que o processamento da tarefa foi concluído e todos os resultados de reconhecimento foram retornados.
headerobjecttask_idstringID da tarefa gerado pelo cliente (formato UUID).
eventstringTipo do evento. Sempre
task-finished.attributesobjectAtributos adicionais. Geralmente vazio.
payloadobjectusageobjectUso acumulado ao final da tarefa. Os campos têm o mesmo significado que em
result-generated.usage.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 (formato UUID).
eventstringTipo do evento. Sempre
task-failed.error_codestringDescrição do tipo de erro.
error_messagestringCausa específica do erro.
attributesobjectAtributos adicionais. Geralmente vazio.
payloadobjectSempre
{}.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: