Référence des événements serveur Qwen-Audio-ASR-Message : démarrage, résultats, fin et échec des tâches, avec les requêtes correspondantes.
Séquence des événements
- Envoyez run-task. Attendez task-started avant d’envoyer l’audio.
- Continuez à envoyer l’audio tout en recevant les événements result-generated.
- Pendant la tâche, utilisez continue-task pour mettre à jour le contexte de conversation. L’audio reste transmis par le canal audio.
- Une fois tout l’audio envoyé, envoyez finish-task et recevez les résultats jusqu’à task-finished. En cas d’échec, le serveur renvoie task-failed.
run-task : WebSocket utilise des trames binaires et AOQ utilise une Audio Track. Pour la connexion, l’authentification et le transport audio, consultez l’API WebSocket ou l’accès AOQ.
task-started
Indique que la tâche a démarré et que le client peut commencer à envoyer l’audio.
headerobjecttask_idstringID de tâche généré par le client, au format UUID.
eventstringType d’événement. La valeur est toujours
task-started.attributesobjectAttributs supplémentaires, généralement vides.
payloadobjectLa valeur est toujours
{}.Requête
Réponse
result-generated
Renvoie les résultats de reconnaissance : débuts de phrases, résultats intermédiaires, résultats finaux de phrases et heartbeats. Les résultats intermédiaires sont désactivés par défaut ; définissez intermediate_result_enabled=true pour les activer.
headerobjecttask_idstringID de tâche généré par le client, au format UUID.
eventstringType d’événement. La valeur est toujours
result-generated.payloadobjectoutputobjectsentenceobjectsentence_idintegerIdentifiant séquentiel de la phrase. Dans les résultats normaux,
sentence_id augmente à partir de 1. Lorsque heartbeat vaut true (paquet heartbeat), sentence_id vaut toujours 0.begin_timeintegerHeure de début de la phrase, en millisecondes.
end_timeintegerHeure de fin de la phrase, en millisecondes.Peut être
null dans les résultats intermédiaires ou les signaux de maintien de connexion.textstringTexte reconnu.
Le texte intermédiaire peut changer au cours de la reconnaissance. Mettez à jour le texte affiché pour le même
sentence_id au lieu de concaténer les textes intermédiaires.sentence_beginbooleanLa valeur
true indique le début d’une phrase. Le champ text peut alors être vide.sentence_endbooleanIndique si la phrase est terminée (
true : résultat final, false : résultat intermédiaire).heartbeatbooleanSi cette valeur est
true, le résultat est un paquet heartbeat et peut être ignoré.wordsarray[object]Informations d’horodatage au niveau des mots.
begin_timeintegerHeure de début du mot, en millisecondes.
end_timeintegerHeure de fin du mot, en millisecondes.
textstringTexte reconnu.
punctuationstringSigne de ponctuation.
usageobjectUtilisation cumulée de la tâche en cours au moment de cet événement.
usage contient l’utilisation cumulée de la tâche actuelle. N’additionnez pas les valeurs de usage des événements. Après la fin de la tâche, utilisez le cumul final dans task-finished.durationintegerDurée audio cumulée en secondes, conservée pour la compatibilité.
input_tokensintegerNombre cumulé de tokens d’entrée.
output_tokensintegerNombre cumulé de tokens de sortie.
total_tokensintegerNombre total cumulé de tokens : somme de
input_tokens et output_tokens.- Début de phrase
- Résultat intermédiaire
- Résultat final de phrase
Requête
Réponse
task-finished
Le traitement de la tâche est terminé et tous les résultats de reconnaissance ont été renvoyés. Le client peut fermer la connexion ou la réutiliser pour démarrer une nouvelle tâche.
headerobjecttask_idstringID de tâche généré par le client, au format UUID.
eventstringType d’événement. La valeur est toujours
task-finished.attributesobjectAttributs supplémentaires, généralement vides.
payloadobjectContient
output (objet vide) et usage (utilisation cumulée finale de la tâche). Les champs usage ont les mêmes définitions que dans result-generated.Requête
Réponse
task-failed
Indique l’échec de la tâche. Consultez error_code et error_message pour en connaître la cause. Après un échec, la connexion WebSocket est fermée et ne peut pas être réutilisée.
headerobjecttask_idstringID de tâche généré par le client, au format UUID.
eventstringType d’événement. La valeur est toujours
task-failed.error_codestringDescription du type d’erreur.
error_messagestringCause précise de l’erreur.
attributesobjectAttributs supplémentaires, généralement vides.
payloadobjectLa valeur est toujours
{}.Cette requête utilise un format audio non pris en charge pour illustrer
task-failed. Le code et le message d’erreur dépendent de la cause de l’échec.Requête
Réponse