Référence des événements serveur Qwen-Audio-ASR-Streaming : 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.
- 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 (format UUID).
eventstringType d'événement. Toujours
task-started.attributesobjectAttributs supplémentaires. Généralement vide.
payloadobjectToujours
{}.Requête
Réponse
result-generated
Renvoie les résultats de reconnaissance : début de phrase, résultats intermédiaires, résultats finaux de phrase et signaux de maintien de connexion.
headerobjecttask_idstringID de tâche généré par le client (format UUID).
eventstringType d'événement. Toujours
result-generated.payloadobjectoutputobjectsentenceobjectsentence_idintegerIdentifiant séquentiel de la phrase. Dans les résultats normaux,
sentence_id s'incrémente à partir de 1. Pour un paquet de battement de cœur (heartbeat vaut true), sentence_id vaut toujours 0.begin_timeintegerHorodatage de début de la phrase, en millisecondes.
end_timeinteger | nullHorodatage 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.
sentence_beginbooleanSignale le début d'une phrase.
sentence_endbooleanIndique si la phrase est terminée (
true = résultat final, false = résultat intermédiaire).heartbeatbooleanSi la valeur est
true, le résultat est un paquet de battement de cœur et peut être ignoré.wordsarray[object]Horodatages au niveau des mots.
begin_timeintegerHorodatage de début du mot, en millisecondes.
end_timeintegerHorodatage de fin du mot, en millisecondes.
textstringTexte reconnu.
punctuationstringSigne de ponctuation.
usageobjectUtilisation cumulée de la tâche en cours.
usage contient l’utilisation cumulée de la tâche et peut être absent de certains résultats intermédiaires. N’additionnez pas les valeurs de usage entre les événements. qwen-audio-3.0-asr-flash-streaming est facturé à la durée et qwen-audio-3.1-asr-flash-streaming aux tokens. Consultez l’applicabilité de chaque champ ci-dessous.durationintegerDurée audio cumulée, en secondes.
Utilisé pour la facturation de qwen-audio-3.0-asr-flash-streaming.
input_tokensintegerNombre cumulé de tokens d’entrée.
S’applique à qwen-audio-3.1-asr-flash-streaming.
output_tokensintegerNombre cumulé de tokens de sortie.
S’applique à qwen-audio-3.1-asr-flash-streaming.
total_tokensintegerNombre total cumulé de tokens, égal à la somme des tokens d’entrée et de sortie.
S’applique à qwen-audio-3.1-asr-flash-streaming.
- Début de phrase
- Résultat intermédiaire
- Résultat final de phrase
- Maintien de connexion
Après réception de
task-started, envoyez l’audio. L’exemple ci-dessous est un événement result-generated renvoyé ensuite par le serveur. L’audio est transmis par trames binaires WebSocket ou par l’Audio Track AOQ.Requête
Réponse
task-finished
Indique que le traitement est terminé et que tous les résultats de reconnaissance de la tâche ont été renvoyés.
headerobjecttask_idstringID de tâche généré par le client (format UUID).
eventstringType d'événement. Toujours
task-finished.attributesobjectAttributs supplémentaires. Généralement vide.
payloadobjectusageobjectUtilisation cumulée à la fin de la tâche. Les champs ont la même signification que dans
result-generated.usage.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 (format UUID).
eventstringType d'événement. Toujours
task-failed.error_codestringDescription du type d'erreur.
error_messagestringCause spécifique de l'erreur.
attributesobjectAttributs supplémentaires. Généralement vide.
payloadobjectToujours
{}.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