Skip to main content

Événements serveur Qwen-Audio-ASR-Message

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

  1. Envoyez run-task. Attendez task-started avant d’envoyer l’audio.
  2. Continuez à envoyer l’audio tout en recevant les événements result-generated.
  3. Pendant la tâche, utilisez continue-task pour mettre à jour le contexte de conversation. L’audio reste transmis par le canal audio.
  4. 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.
L’audio n’est pas envoyé dans 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.
Attendez task-started avant d’envoyer l’audio. run-task sert uniquement à démarrer et à configurer la tâche ; il ne contient pas de données audio.
headerobject
task_idstring
ID de tâche généré par le client, au format UUID.
eventstring
Type d’événement. La valeur est toujours task-started.
attributesobject
Attributs supplémentaires, généralement vides.
payloadobject
La valeur est toujours {}.
Requête
{
  "header": {
    "action": "run-task",
    "task_id": "ab4f7812-2d71-4e3d-93d3-b68ab80d3755",
    "streaming": "duplex"
  },
  "payload": {
    "input": {},
    "task_group": "audio",
    "task": "asr",
    "function": "recognition",
    "model": "qwen-audio-3.1-asr-flash-message",
    "parameters": {
      "format": "pcm",
      "sample_rate": 16000
    }
  }
}
Réponse
{
  "header": {
    "task_id": "ab4f7812-2d71-4e3d-93d3-b68ab80d3755",
    "task_uuid": "852196dba9d14bea9cf0d6e04ff0b027",
    "event": "task-started",
    "attributes": {}
  },
  "payload": {}
}

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.
sentence_end=true indique la fin d’une phrase, pas celle de la tâche. Les résultats de maintien de connexion (heartbeat=true) peuvent être ignorés. La tâche se termine à la réception de task-finished.
headerobject
task_idstring
ID de tâche généré par le client, au format UUID.
eventstring
Type d’événement. La valeur est toujours result-generated.
payloadobject
outputobject
sentenceobject
sentence_idinteger
Identifiant 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_timeinteger
Heure de début de la phrase, en millisecondes.
end_timeinteger
Heure de fin de la phrase, en millisecondes.Peut être null dans les résultats intermédiaires ou les signaux de maintien de connexion.
textstring
Texte 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_beginboolean
La valeur true indique le début d’une phrase. Le champ text peut alors être vide.
sentence_endboolean
Indique si la phrase est terminée (true : résultat final, false : résultat intermédiaire).
heartbeatboolean
Si 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_timeinteger
Heure de début du mot, en millisecondes.
end_timeinteger
Heure de fin du mot, en millisecondes.
textstring
Texte reconnu.
punctuationstring
Signe de ponctuation.
usageobject
Utilisation 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.
durationinteger
Durée audio cumulée en secondes, conservée pour la compatibilité.
input_tokensinteger
Nombre cumulé de tokens d’entrée.
output_tokensinteger
Nombre cumulé de tokens de sortie.
total_tokensinteger
Nombre 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
{
  "header": {
    "action": "run-task",
    "task_id": "ab4f7812-2d71-4e3d-93d3-b68ab80d3755",
    "streaming": "duplex"
  },
  "payload": {
    "input": {},
    "task_group": "audio",
    "task": "asr",
    "function": "recognition",
    "model": "qwen-audio-3.1-asr-flash-message",
    "parameters": {
      "format": "pcm",
      "sample_rate": 16000
    }
  }
}
Réponse
{
  "header": {
    "task_id": "ab4f7812-2d71-4e3d-93d3-b68ab80d3755",
    "event": "result-generated",
    "attributes": {}
  },
  "payload": {
    "output": {
      "sentence": {
        "sentence_id": 1,
        "begin_time": 0,
        "end_time": null,
        "text": "",
        "sentence_end": false,
        "sentence_begin": true,
        "words": []
      }
    }
  }
}

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.
headerobject
task_idstring
ID de tâche généré par le client, au format UUID.
eventstring
Type d’événement. La valeur est toujours task-finished.
attributesobject
Attributs supplémentaires, généralement vides.
payloadobject
Contient 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
{
  "header": {
    "action": "finish-task",
    "task_id": "ab4f7812-2d71-4e3d-93d3-b68ab80d3755",
    "streaming": "duplex"
  },
  "payload": {
    "input": {}
  }
}
Réponse
{
  "header": {
    "task_id": "ab4f7812-2d71-4e3d-93d3-b68ab80d3755",
    "event": "task-finished",
    "attributes": {}
  },
  "payload": {
    "output": {},
    "usage": {
      "duration": 4,
      "input_tokens": 51,
      "output_tokens": 13,
      "total_tokens": 64
    }
  }
}

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.
headerobject
task_idstring
ID de tâche généré par le client, au format UUID.
eventstring
Type d’événement. La valeur est toujours task-failed.
error_codestring
Description du type d’erreur.
error_messagestring
Cause précise de l’erreur.
attributesobject
Attributs supplémentaires, généralement vides.
payloadobject
La 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
{
  "header": {
    "action": "run-task",
    "task_id": "5927b897-6890-45cd-9b85-bc58bdaaadfb",
    "streaming": "duplex"
  },
  "payload": {
    "input": {},
    "task_group": "audio",
    "task": "asr",
    "function": "recognition",
    "model": "qwen-audio-3.1-asr-flash-message",
    "parameters": {
      "format": "invalid-format",
      "sample_rate": 16000
    }
  }
}
Réponse
{
  "header": {
    "task_id": "5927b897-6890-45cd-9b85-bc58bdaaadfb",
    "event": "task-failed",
    "error_code": "UNSUPPORTED_FORMAT",
    "error_message": "UNSUPPORTED_FORMAT"
  },
  "payload": {}
}