Skip to main content

Eventos del servidor

Eventos del servidor para la API Qwen-TTS-Realtime.

Referencia: Síntesis de voz en tiempo real.

error

Enviado tanto para errores del lado del cliente como del lado del servidor.
event_idstringEl ID del evento del lado del servidor.typestringEl tipo de evento. Este valor siempre es error.errorobjectLos detalles del error.

Propiedades

codestringEl código de error.messagestringEl mensaje de error.
{
  "event_id": "event_QzAVZRVa9hKqM5VOaHunh",
  "type": "error",
  "error": {
    "code": "invalid_value",
    "message": "Session update error: session already started or finished or failed."
  }
}

session.created

Se envía cuando un cliente se conecta. Incluye la configuración predeterminada de la sesión.
event_idstringEl ID del evento del lado del servidor.typestringEl tipo de evento. Este valor siempre es session.created.sessionobjectLa configuración de la sesión.

Propiedades

idstringEl ID de sesión.objectstringEl nombre del servicio de sesión.modestringEl modo de interacción. Los valores válidos son server_commit o commit.modelstringEl modelo en uso.voicestringLa voz en uso.response_formatstringEl formato de audio.sample_rateintegerLa tasa de muestreo del audio.
{
  "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"
  }
}

session.updated

Se envía después de que el servidor procesa correctamente una solicitud session.update. En caso de error, se envía un evento error en su lugar.
event_idstringEl ID del evento del lado del servidor.typestringEl tipo de evento. Este valor siempre es session.updated.sessionobjectLa configuración de la sesión.

Propiedades

idstringEl ID de sesión.objectstringEl nombre del servicio de sesión.modestringEl modo de interacción. Los valores válidos son server_commit o commit.modelstringEl modelo en uso.voicestringLa voz en uso.response_formatstringEl formato de audio.sample_rateintegerLa tasa de muestreo del audio.language_typestringEl idioma del audio.
{
  "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
  }
}

input_text_buffer.committed

Se envía después de que el servidor recibe un evento input_text_buffer.commit.
event_idstringEl ID del evento del lado del servidor.typestringEl tipo de evento. Este valor siempre es input_text_buffer.committed.item_idstringEl ID del elemento de mensaje de usuario a crear.
{
  "event_id": "event_FC6MA88wS2oEeXkPvWsxX",
  "type": "input_text_buffer.committed",
  "item_id": ""
}

input_text_buffer.cleared

El evento de respuesta del servidor después de que el cliente envía el evento input_text_buffer.clear.
event_idstringEl ID del evento del lado del servidor.typestringEl tipo de evento. Este valor siempre es input_text_buffer.cleared.
{
    "event_id": "event_1122",
    "type": "input_text_buffer.cleared"
}

response.created

El servidor envía este evento después de recibir un evento input_text_buffer.commit del cliente.
event_idstringEl ID del evento del lado del servidor.typestringEl tipo de evento. Este valor siempre es response.created.responseobjectLos detalles de la respuesta.

Propiedades

idstringEl ID de respuesta.objectstringEl tipo de objeto. Este valor siempre es realtime.response.statusstringEl estado final de la respuesta. Los valores válidos son:
  • completado
  • fallido
  • in_progress
  • incomplete
voicestringLa voz en uso.outputarrayEste campo está vacío para este evento.
{
  "event_id": "event_IMnLqDvG6Ahhk7sWV2uOs",
  "type": "response.created",
  "response": {
    "id": "resp_USvBwHktHcz76r6GaIJUV",
    "object": "realtime.response",
    "conversation_id": "",
    "status": "in_progress",
    "voice": "Cherry",
    "output": []
  }
}

response.output_item.added

Enviado cuando un nuevo elemento de salida está listo.
event_idstringEl ID del evento del lado del servidor.typestringEl tipo de evento. Este valor siempre es response.output_item.added.response_idstringEl ID de la respuesta.output_indexintegerEl índice del elemento de salida de la respuesta. Este valor siempre es 0.itemobjectLos detalles del elemento de salida.

Propiedades

idstringEl ID del elemento de salida.objectstringEste valor siempre es realtime.item.statusstringEl estado del elemento de salida.contentarrayEl contenido del mensaje.
{
  "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": []
  }
}

response.content_part.added

Enviado cuando una nueva parte del contenido está lista.
event_idstringEl ID del evento del lado del servidor.typestringEl tipo de evento. Este valor siempre es response.content_part.added.response_idstringEl ID de la respuesta.item_idstringEl ID del elemento de mensaje.output_indexintegerEl índice del elemento de salida de la respuesta. Este valor siempre es 0.content_indexintegerEl índice de la parte de contenido dentro del elemento de salida de la respuesta. Este valor siempre es 0.partobjectLa parte de contenido completada.

Propiedades

typestringEl tipo de la parte de contenido.textstringEl texto de la parte de contenido.
{
  "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": ""
  }
}

response.audio.delta

Se envía cuando el modelo genera nuevos datos de audio de forma incremental.
event_idstringEl ID del evento del lado del servidor.typestringEl tipo de evento. Este valor siempre es response.audio.delta.response_idstringEl ID de la respuesta.item_idstringEl ID del elemento de mensaje.output_indexintegerEl índice del elemento de salida de la respuesta. Este valor siempre es 0.content_indexintegerEl índice de la parte de contenido dentro del elemento de salida de la respuesta. Este valor siempre es 0.deltastringDatos de audio generados de forma incremental por el modelo. Los datos están codificados en Base64.
{
  "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"
}

response.content_part.done

Enviado cuando una parte del contenido está completa.
event_idstringEl ID del evento del lado del servidor.typestringEl tipo de evento. Este valor siempre es response.content_part.done.response_idstringEl ID de la respuesta.item_idstringEl ID del elemento de mensaje.output_indexintegerEl índice del elemento de salida de la respuesta. Este valor siempre es 0.content_indexintegerEl índice de la parte de contenido dentro del elemento de salida de la respuesta. Este valor siempre es 0.partobjectLa parte de contenido completada.

Propiedades

typestringEl tipo de la parte de contenido.textstringEl texto de la parte de contenido.
{
  "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": ""
  }
}

response.output_item.done

Enviado cuando un elemento de salida está completo.
event_idstringEl ID del evento del lado del servidor.typestringEl tipo de evento. Este valor siempre es response.output_item.done.response_idstringEl ID de la respuesta.output_indexintegerEl índice del elemento de salida de la respuesta. Este valor siempre es 0.itemobjectLos detalles del elemento de salida.

Propiedades

idstringEl ID del elemento de salida.objectstringEste valor siempre es realtime.item.statusstringEl estado del elemento de salida.contentarrayEl contenido del mensaje.
{
  "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": ""
      }
    ]
  }
}

response.audio.done

Enviado cuando el modelo termina de generar datos de audio.
event_idstringEl ID del evento del lado del servidor.typestringEl tipo de evento. Este valor siempre es response.audio.done.response_idstringEl ID de la respuesta.item_idstringEl ID del elemento de mensaje.output_indexintegerEl índice del elemento de salida de la respuesta. Este valor siempre es 0.content_indexintegerEl índice de la parte de contenido dentro del elemento de salida de la respuesta. Este valor siempre es 0.
{
  "event_id": "event_LZaOHPzXYMUXGBcVkBmKX",
  "type": "response.audio.done",
  "response_id": "resp_USvBwHktHcz76r6GaIJUV",
  "item_id": "item_FIrYGaNVK3rbIZqeY4QjM",
  "output_index": 0,
  "content_index": 0
}

response.done

Se envía cuando se completa la generación de la respuesta. El objeto response contiene todos los elementos de salida, pero excluye los datos de audio sin procesar ya enviados.
event_idstringEl ID del evento del lado del servidor.typestringEl tipo de evento. Este valor siempre es response.done.response_idstringEl ID de la respuesta.responseobjectLos detalles de la respuesta.

Propiedades

idstringEl ID de respuesta.objectstringEl tipo de objeto. Este valor siempre es realtime.response.outputarraySalida de la respuesta.usageobjectInformación de facturación para esta solicitud de síntesis de voz.

Propiedades

charactersintegerEl número de caracteres facturados para 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
        }
    }
}

session.finished

Enviado cuando se han generado todas las respuestas.
event_idstringEl ID del evento del lado del servidor.typestringEl tipo de evento. Este valor siempre es session.finished.
{
  "event_id": "event_2239",
  "type": "session.finished"
}