Server events - Alibaba Cloud Model Studio - Centre de documentation Alibaba Cloud

É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_idstring

ID 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."
  }
}

typestring

Type de l'événement. Cette valeur est toujours error.

errorobject

Détails de l'erreur.

Properties

codestring

Code d'erreur.

messagestring

Message d'erreur.

session.created

Envoyé lors de la connexion d'un client. Inclut la configuration de session par défaut.

event_idstring

ID 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"
  }
}

typestring

Type de l'événement. Cette valeur est toujours session.created.

sessionobject

Configuration de la session.

Properties

idstring

ID de la session.

objectstring

Nom du service de session.

modestring

Mode d'interaction. Valeurs valides : server_commit ou commit.

modelstring

Modèle utilisé.

voicestring

Voix utilisée.

response_formatstring

Format audio.

sample_rateinteger

Taux 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_idstring

ID 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
  }
}

typestring

Type de l'événement. Cette valeur est toujours session.updated.

sessionobject

Configuration de la session.

Properties

idstring

ID de la session.

objectstring

Nom du service de session.

modestring

Mode d'interaction. Valeurs valides : server_commit ou commit.

modelstring

Modèle utilisé.

voicestring

Voix utilisée.

response_formatstring

Format audio.

sample_rateinteger

Taux d'échantillonnage audio.

language_typestring

Langue de l'audio.

input_text_buffer.committed

Envoyé après réception par le serveur d'un événement input_text_buffer.commit.

event_idstring

ID de l'événement côté serveur.

{
  "event_id": "event_FC6MA88wS2oEeXkPvWsxX",
  "type": "input_text_buffer.committed",
  "item_id": ""
}

typestring

Type de l'événement. Cette valeur est toujours input_text_buffer.committed.

item_idstring

ID 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_idstring

ID de l'événement côté serveur.

{
    "event_id": "event_1122",
    "type": "input_text_buffer.cleared"
}

typestring

Type 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_idstring

ID 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": []
  }
}

typestring

Type de l'événement. Cette valeur est toujours response.created.

responseobject

Détails de la réponse.

Properties

idstring

ID de la réponse.

objectstring

Type d'objet. Cette valeur est toujours realtime.response.

statusstring

Statut final de la réponse. Valeurs valides :

completed
failed
in_progress
incomplete

voicestring

Voix utilisée.

outputarray

Ce champ est vide pour cet événement.

response.output_item.added

Envoyé lorsqu'un nouvel élément de sortie est prêt.

event_idstring

ID 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": []
  }
}

typestring

Type de l'événement. Cette valeur est toujours response.output_item.added.

response_idstring

ID de la réponse.

output_indexinteger

Index de l'élément de sortie de la réponse. Cette valeur est toujours 0.

itemobject

Détails de l'élément de sortie.

Properties

idstring

ID de l'élément de sortie.

objectstring

Cette valeur est toujours realtime.item.

statusstring

Statut de l'élément de sortie.

contentarray

Contenu du message.

response.content_part.added

Envoyé lorsqu'une nouvelle partie de contenu est prête.

event_idstring

ID 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": ""
  }
}

typestring

Type de l'événement. Cette valeur est toujours response.content_part.added.

response_idstring

ID de la réponse.

item_idstring

ID de l'élément de message.

output_indexinteger

Index de l'élément de sortie de la réponse. Cette valeur est toujours 0.

content_indexinteger

Index de la partie de contenu dans l'élément de sortie de la réponse. Cette valeur est toujours 0.

partobject

Partie de contenu terminée.

Properties

typestring

Type de la partie de contenu.

textstring

Texte 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_idstring

ID 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"
}

typestring

Type de l'événement. Cette valeur est toujours response.audio.delta.

response_idstring

ID de la réponse.

item_idstring

ID de l'élément de message.

output_indexinteger

Index de l'élément de sortie de la réponse. Cette valeur est toujours 0.

content_indexinteger

Index de la partie de contenu dans l'élément de sortie de la réponse. Cette valeur est toujours 0.

deltastring

Donné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_idstring

ID 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": ""
  }
}

typestring

Type de l'événement. Cette valeur est toujours response.content_part.done.

response_idstring

ID de la réponse.

item_idstring

ID de l'élément de message.

output_indexinteger

Index de l'élément de sortie de la réponse. Cette valeur est toujours 0.

content_indexinteger

Index de la partie de contenu dans l'élément de sortie de la réponse. Cette valeur est toujours 0.

partobject

Partie de contenu terminée.

Properties

typestring

Type de la partie de contenu.

textstring

Texte de la partie de contenu.

response.output_item.done

Envoyé lorsqu'un élément de sortie est terminé.

event_idstring

ID 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": ""
      }
    ]
  }
}

typestring

Type de l'événement. Cette valeur est toujours response.output_item.done.

response_idstring

ID de la réponse.

output_indexinteger

Index de l'élément de sortie de la réponse. Cette valeur est toujours 0.

itemobject

Détails de l'élément de sortie.

Properties

idstring

ID de l'élément de sortie.

objectstring

Cette valeur est toujours realtime.item.

statusstring

Statut de l'élément de sortie.

contentarray

Contenu du message.

response.audio.done

Envoyé lorsque le modèle a terminé la génération des données audio.

event_idstring

ID 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
}

typestring

Type de l'événement. Cette valeur est toujours response.audio.done.

response_idstring

ID de la réponse.

item_idstring

ID de l'élément de message.

output_indexinteger

Index de l'élément de sortie de la réponse. Cette valeur est toujours 0.

content_indexinteger

Index 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_idstring

ID de l'événement côté serveur.

Qwen3-TTS Realtime

{
    "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
        }
    }
}

typestring

Type de l'événement. Cette valeur est toujours response.done.

response_idstring

ID de la réponse.

responseobject

Détails de la réponse.

Properties

idstring

ID de la réponse.

objectstring

Type d'objet. Cette valeur est toujours realtime.response.

outputarray

Sortie de la réponse.

usageobject

Informations de facturation pour cette requête de synthèse vocale.

Properties

charactersinteger

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

session.finished

Envoyé lorsque toutes les réponses ont été générées.

event_idstring

ID de l'événement côté serveur.

{
  "event_id": "event_2239",
  "type": "session.finished"
}

typestring

Type de l'événement. Cette valeur est toujours session.finished.