Skip to main content

Server events

Événements serveur de l'API Qwen-TTS-Realtime.

Référence : Synthèse vocale en temps réel .

error

Envoyé pour les erreurs côté client et côté serveur.
event_idstringID de l'événement côté serveur.
{
  "event_id": "event_QzAVZRVa9hKqM5VOaHunh",
  "type": "error",
  "error": {
    "code": "invalid_value",
    "message": "Session update error: session already started or finished or failed."
  }
}
typestringType de l'événement. Cette valeur est toujours error.
errorobjectDétails de l'erreur.

Properties

codestringCode d'erreur.messagestringMessage d'erreur.

session.created

Envoyé lors de la connexion d'un client. Inclut la configuration de session par défaut.
event_idstringID de l'événement côté serveur.
{
  "event_id": "event_xxx",
  "type": "session.created",
  "session": {
    "object": "realtime.session",
    "mode": "server_commit",
    "model": "qwen3-tts-flash-realtime",
    "voice": "Cherry",
    "response_format": "pcm",
    "sample_rate": 24000,
    "id": "sess_xxx"
  }
}
typestringType de l'événement. Cette valeur est toujours session.created.
sessionobjectConfiguration de la session.

Properties

idstringID de la session.objectstringNom du service de session.modestringMode d'interaction. Valeurs valides : server_commit ou commit.modelstringModèle utilisé.voicestringVoix utilisée.response_formatstringFormat audio.sample_rateintegerTaux d'échantillonnage audio.

session.updated

Envoyé après le traitement réussi d'une requête session.update par le serveur. En cas d'erreur, un événement error est envoyé à la place.
event_idstringID de l'événement côté serveur.
{
  "event_id": "event_xxx",
  "type": "session.updated",
  "session": {
    "id": "sess_xxx",
    "object": "realtime.session",
    "model": "qwen3-tts-flash-realtime",
    "voice": "Cherry",
    "language_type": "Chinese",
    "mode": "commit",
    "response_format": "pcm",
    "sample_rate": 24000
  }
}
typestringType de l'événement. Cette valeur est toujours session.updated.
sessionobjectConfiguration de la session.

Properties

idstringID de la session.objectstringNom du service de session.modestringMode d'interaction. Valeurs valides : server_commit ou commit.modelstringModèle utilisé.voicestringVoix utilisée.response_formatstringFormat audio.sample_rateintegerTaux d'échantillonnage audio.language_typestringLangue de l'audio.

input_text_buffer.committed

Envoyé après réception par le serveur d'un événement input_text_buffer.commit.
event_idstringID de l'événement côté serveur.
{
  "event_id": "event_FC6MA88wS2oEeXkPvWsxX",
  "type": "input_text_buffer.committed",
  "item_id": ""
}
typestringType de l'événement. Cette valeur est toujours input_text_buffer.committed.
item_idstringID de l'élément de message utilisateur à créer.

input_text_buffer.cleared

Réponse du serveur suite à l'envoi par le client de l'événement input_text_buffer.clear.
event_idstringID de l'événement côté serveur.
{
    "event_id": "event_1122",
    "type": "input_text_buffer.cleared"
}
typestringType de l'événement. Cette valeur est toujours input_text_buffer.cleared.

response.created

Le serveur envoie cet événement après réception d'un événement input_text_buffer.commit provenant du client.
event_idstringID de l'événement côté serveur.
{
  "event_id": "event_IMnLqDvG6Ahhk7sWV2uOs",
  "type": "response.created",
  "response": {
    "id": "resp_USvBwHktHcz76r6GaIJUV",
    "object": "realtime.response",
    "conversation_id": "",
    "status": "in_progress",
    "voice": "Cherry",
    "output": []
  }
}
typestringType de l'événement. Cette valeur est toujours response.created.
responseobjectDétails de la réponse.

Properties

idstringID de la réponse.objectstringType d'objet. Cette valeur est toujours realtime.response.statusstringStatut final de la réponse. Valeurs valides :
  • completed
  • failed
  • in_progress
  • incomplete
voicestringVoix utilisée.outputarrayCe champ est vide pour cet événement.

response.output_item.added

Envoyé lorsqu'un nouvel élément de sortie est prêt.
event_idstringID de l'événement côté serveur.
{
  "event_id": "event_INDGnGNulaXCrStd9ZM5X",
  "type": "response.output_item.added",
  "response_id": "resp_USvBwHktHcz76r6GaIJUV",
  "output_index": 0,
  "item": {
    "id": "item_FIrYGaNVK3rbIZqeY4QjM",
    "object": "realtime.item",
    "type": "message",
    "status": "in_progress",
    "role": "assistant",
    "content": []
  }
}
typestringType de l'événement. Cette valeur est toujours response.output_item.added.
response_idstringID de la réponse.
output_indexintegerIndex de l'élément de sortie de la réponse. Cette valeur est toujours 0.
itemobjectDétails de l'élément de sortie.

Properties

idstringID de l'élément de sortie.objectstringCette valeur est toujours realtime.item.statusstringStatut de l'élément de sortie.contentarrayContenu du message.

response.content_part.added

Envoyé lorsqu'une nouvelle partie de contenu est prête.
event_idstringID de l'événement côté serveur.
{
  "event_id": "event_DigZ95MWN36YYyyjcENoq",
  "type": "response.content_part.added",
  "response_id": "resp_USvBwHktHcz76r6GaIJUV",
  "item_id": "item_FIrYGaNVK3rbIZqeY4QjM",
  "output_index": 0,
  "content_index": 0,
  "part": {
    "type": "audio",
    "text": ""
  }
}
typestringType de l'événement. Cette valeur est toujours response.content_part.added.
response_idstringID de la réponse.
item_idstringID de l'élément de message.
output_indexintegerIndex de l'élément de sortie de la réponse. Cette valeur est toujours 0.
content_indexintegerIndex de la partie de contenu dans l'élément de sortie de la réponse. Cette valeur est toujours 0.
partobjectPartie de contenu terminée.

Properties

typestringType de la partie de contenu.textstringTexte de la partie de contenu.

response.audio.delta

Envoyé lorsque le modèle génère de nouvelles données audio de manière incrémentielle.
event_idstringID de l'événement côté serveur.
{
  "event_id": "event_B1osWMZBtrEQbiIwW0qHQ",
  "type": "response.audio.delta",
  "response_id": "resp_B1osWTzBb8hO0WsELHgVP",
  "item_id": "item_B1osWH81fXDoyim1T5fsF",
  "output_index": 0,
  "content_index": 0,
  "delta": "base64 audio"
}
typestringType de l'événement. Cette valeur est toujours response.audio.delta.
response_idstringID de la réponse.
item_idstringID de l'élément de message.
output_indexintegerIndex de l'élément de sortie de la réponse. Cette valeur est toujours 0.
content_indexintegerIndex de la partie de contenu dans l'élément de sortie de la réponse. Cette valeur est toujours 0.
deltastringDonnées audio générées de manière incrémentielle par le modèle. Les données sont encodées en Base64.

response.content_part.done

Envoyé lorsqu'une partie de contenu est terminée.
event_idstringID de l'événement côté serveur.
{
  "event_id": "event_Vo2YUjlYQJ4colH8nVzkU",
  "type": "response.content_part.done",
  "response_id": "resp_USvBwHktHcz76r6GaIJUV",
  "item_id": "item_FIrYGaNVK3rbIZqeY4QjM",
  "output_index": 0,
  "content_index": 0,
  "part": {
    "type": "audio",
    "text": ""
  }
}
typestringType de l'événement. Cette valeur est toujours response.content_part.done.
response_idstringID de la réponse.
item_idstringID de l'élément de message.
output_indexintegerIndex de l'élément de sortie de la réponse. Cette valeur est toujours 0.
content_indexintegerIndex de la partie de contenu dans l'élément de sortie de la réponse. Cette valeur est toujours 0.
partobjectPartie de contenu terminée.

Properties

typestringType de la partie de contenu.textstringTexte de la partie de contenu.

response.output_item.done

Envoyé lorsqu'un élément de sortie est terminé.
event_idstringID de l'événement côté serveur.
{
  "event_id": "event_LO6SJRKIQ9NBayyYB8a1A",
  "type": "response.output_item.done",
  "response_id": "resp_USvBwHktHcz76r6GaIJUV",
  "output_index": 0,
  "item": {
    "id": "item_FIrYGaNVK3rbIZqeY4QjM",
    "object": "realtime.item",
    "type": "message",
    "status": "completed",
    "role": "assistant",
    "content": [
      {
        "type": "audio",
        "text": ""
      }
    ]
  }
}
typestringType de l'événement. Cette valeur est toujours response.output_item.done.
response_idstringID de la réponse.
output_indexintegerIndex de l'élément de sortie de la réponse. Cette valeur est toujours 0.
itemobjectDétails de l'élément de sortie.

Properties

idstringID de l'élément de sortie.objectstringCette valeur est toujours realtime.item.statusstringStatut de l'élément de sortie.contentarrayContenu du message.

response.audio.done

Envoyé lorsque le modèle a terminé la génération des données audio.
event_idstringID de l'événement côté serveur.
{
  "event_id": "event_LZaOHPzXYMUXGBcVkBmKX",
  "type": "response.audio.done",
  "response_id": "resp_USvBwHktHcz76r6GaIJUV",
  "item_id": "item_FIrYGaNVK3rbIZqeY4QjM",
  "output_index": 0,
  "content_index": 0
}
typestringType de l'événement. Cette valeur est toujours response.audio.done.
response_idstringID de la réponse.
item_idstringID de l'élément de message.
output_indexintegerIndex de l'élément de sortie de la réponse. Cette valeur est toujours 0.
content_indexintegerIndex de la partie de contenu dans l'élément de sortie de la réponse. Cette valeur est toujours 0.

response.done

Envoyé lorsque la génération de la réponse est terminée. L'objet response contient tous les éléments de sortie, mais exclut les données audio brutes déjà envoyées.
event_idstringID de l'événement côté serveur.
{
    "event_id": "event_Aemy83XqHFFDDSeJIDn6N",
    "type": "response.done",
    "response": {
        "id": "resp_LFeR42yXZ9SxUAeXjmyTz",
        "object": "realtime.response",
        "conversation_id": "",
        "status": "completed",
        "modalities": [
            "text",
            "audio"
        ],
        "voice": "Cherry",
        "output": [
            {
                "id": "item_Ae1lv2XmRljRSG96L8Zm1",
                "object": "realtime.item",
                "type": "message",
                "status": "completed",
                "role": "assistant",
                "content": [
                    {
                        "type": "audio",
                        "transcript": ""
                    }
                ]
            }
        ],
        "usage": {
            "characters": 25
        }
    }
}
typestringType de l'événement. Cette valeur est toujours response.done.
response_idstringID de la réponse.
responseobjectDétails de la réponse.

Properties

idstringID de la réponse.objectstringType d'objet. Cette valeur est toujours realtime.response.outputarraySortie de la réponse.usageobjectInformations de facturation pour cette requête de synthèse vocale.

Properties

charactersintegerNombre de caractères facturés pour Qwen3-TTS Realtime.

session.finished

Envoyé lorsque toutes les réponses ont été générées.
event_idstringID de l'événement côté serveur.
{
  "event_id": "event_2239",
  "type": "session.finished"
}
typestringType de l'événement. Cette valeur est toujours session.finished.