Este tópico descreve os eventos que o cliente envia ao servidor via WebSocket no service de reconhecimento de fala em tempo real Fun-ASR-Realtime. O conteúdo inclui as estruturas de dados e definições de campos para run-task (iniciar uma tarefa) e finish-task (encerrar uma tarefa).
run-task
Inicia uma tarefa de reconhecimento de fala e define parâmetros como modelo, formato de áudio e taxa de amostragem.
Quando enviar: Envie imediatamente após o estabelecimento da conexão WebSocket.
Evento de resposta: O envio de áudio só é permitido após o servidor retornar o evento task-started.
headerobject(Required)
Properties action string(Required)O tipo de comando. Defina como run-task.task_idstring(Required)Um ID de tarefa gerado pelo cliente (formato UUID) que vincula os eventos subsequentes a esta tarefa.streamingstring(Required)Defina como duplex. | |
payloadobject(Required)
Properties task_group string(Required)O grupo da tarefa. Defina como audio.taskstring(Required)O tipo de tarefa. Defina como asr.functionstring(Required)O tipo de função. Defina como recognition.modelstring(Required)O nome do modelo.inputobject(Required)O objeto de entrada. Passe {} quando nenhum contexto for fornecido.
Properties context array(object)(Optional)O contexto da conversa, que melhora a precisão do reconhecimento para vocabulário específico de domínio. Para detalhes de uso, consulte Context enhancement.
Properties role string(Required)A função da mensagem. Valores válidos:
array(object)(Required)A lista de conteúdos da mensagem.
Properties type string(Required)O tipo de conteúdo. Valores válidos:
string(Required)O conteúdo de texto. Quando type for input_text, insira os resultados de reconhecimento de turnos anteriores da fala do usuário ou uma lista de palavras específicas de domínio. Quando type for text, insira as respostas do modelo de linguagem grande em turnos anteriores.object(Required)Os parâmetros de reconhecimento de fala.
Properties format string(Required)O formato de áudio.Valores válidos:
integer(Required)A taxa de amostragem, em Hz.Valores válidos: modelos de 8 kHz suportam apenas 8000 Hz; outros modelos suportam qualquer taxa de amostragem.vocabulary_idstring(Optional)O ID de uma lista de palavras-chave pré-compilada.Gere esse ID antecipadamente chamando a API de criação de lista de palavras-chave. Passe o ID durante o reconhecimento para usar as palavras-chave da lista.Indicado para cenários onde o vocabulário é conhecido e relativamente estável, e onde há necessidade de reutilizar a mesma lista de palavras entre requisições.Para detalhes de uso, consulte Precompiled hotwords.language_hintsarray[string](Optional)O idioma do áudio a ser reconhecido. Não há valor padrão; se não for definido, o modelo detecta o idioma automaticamente.Você pode definir 1 valor. Se definir mais, somente o primeiro terá efeito.
Clique em visualizar os códigos de idioma suportados
integer(Optional)O limiar de silêncio VAD para segmentação, em ms. Quando o silêncio após um segmento de fala excede esse limiar, o sistema determina que a frase terminou.Valor padrão: 1300.Valores válidos: [200, 6000].multi_threshold_mode_enabledboolean(Optional)Se deve ativar o modo de múltiplos limiares. Quando ativado, evita que os segmentos VAD fiquem muito longos.Valor padrão: false.heartbeatboolean(Optional)Se deve ativar pacotes de heartbeat.Valor padrão: false.
float(Optional)O limiar para distinguir fala de ruído, usado para ajustar a sensibilidade da Detecção de Atividade de Voz (VAD).Valores válidos: [-1,0, 1,0].Descrições dos valores:
string(Optional)Regras de filtragem que substituem palavras específicas nos resultados pelo mesmo número de asteriscos ou as removem. O valor é uma string JSON serializada a partir do objeto de regras. É possível configurar até 32 palavras sensíveis. Nenhuma filtragem é aplicada se o parâmetro for omitido.
|
finish-task
Notifica o servidor de que todo o áudio foi enviado e solicita o encerramento da tarefa.
Quando enviar: Envie após todos os dados de áudio terem sido transmitidos.
Evento de resposta: O servidor retorna o evento task-finished.
headerobject(Required)
Properties action string(Required)O tipo de comando. Defina como finish-task.task_idstring(Required)Um ID de tarefa gerado pelo cliente (formato UUID) que deve corresponder ao task_id no evento run-task.streamingstring(Required)Defina como duplex. | |
payloadobject(Required)
Properties input object(Required)Defina como {}. |