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_id string
El ID del evento del lado del servidor.
type string
El tipo de evento. Este valor siempre es error.
error object
Los detalles del error.
Propiedades
code string
El código de error.
message string
El 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_id string
El ID del evento del lado del servidor.
type string
El tipo de evento. Este valor siempre es session.created.
session object
La configuración de la sesión.
Propiedades
id string
El ID de sesión.
object string
El nombre del servicio de sesión.
mode string
El modo de interacción. Los valores válidos son server_commit o commit.
model string
El modelo en uso.
voice string
La voz en uso.
response_format string
El formato de audio.
sample_rate integer
La 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_id string
El ID del evento del lado del servidor.
type string
El tipo de evento. Este valor siempre es session.updated.
session object
La configuración de la sesión.
Propiedades
id string
El ID de sesión.
object string
El nombre del servicio de sesión.
mode string
El modo de interacción. Los valores válidos son server_commit o commit.
model string
El modelo en uso.
voice string
La voz en uso.
response_format string
El formato de audio.
sample_rate integer
La tasa de muestreo del audio.
language_type string
El 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_id string
El ID del evento del lado del servidor.
type string
El tipo de evento. Este valor siempre es input_text_buffer.committed.
item_id string
El 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_id string
El ID del evento del lado del servidor.
type string
El 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_id string
El ID del evento del lado del servidor.
type string
El tipo de evento. Este valor siempre es response.created.
response object
Los detalles de la respuesta.
Propiedades
id string
El ID de respuesta.
object string
El tipo de objeto. Este valor siempre es realtime.response.
status string
El estado final de la respuesta. Los valores válidos son:
completado
fallido
in_progress
incomplete
voice string
La voz en uso.
output array
Este 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_id string
El ID del evento del lado del servidor.
type string
El tipo de evento. Este valor siempre es response.output_item.added.
response_id string
El ID de la respuesta.
output_index integer
El índice del elemento de salida de la respuesta. Este valor siempre es 0.
item object
Los detalles del elemento de salida.
Propiedades
id string
El ID del elemento de salida.
object string
Este valor siempre es realtime.item.
status string
El estado del elemento de salida.
content array
El 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_id string
El ID del evento del lado del servidor.
type string
El tipo de evento. Este valor siempre es response.content_part.added.
response_id string
El ID de la respuesta.
item_id string
El ID del elemento de mensaje.
output_index integer
El índice del elemento de salida de la respuesta. Este valor siempre es 0.
content_index integer
El índice de la parte de contenido dentro del elemento de salida de la respuesta. Este valor siempre es 0.
part object
La parte de contenido completada.
Propiedades
type string
El tipo de la parte de contenido.
text string
El 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_id string
El ID del evento del lado del servidor.
type string
El tipo de evento. Este valor siempre es response.audio.delta.
response_id string
El ID de la respuesta.
item_id string
El ID del elemento de mensaje.
output_index integer
El índice del elemento de salida de la respuesta. Este valor siempre es 0.
content_index integer
El índice de la parte de contenido dentro del elemento de salida de la respuesta. Este valor siempre es 0.
delta string
Datos 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_id string
El ID del evento del lado del servidor.
type string
El tipo de evento. Este valor siempre es response.content_part.done.
response_id string
El ID de la respuesta.
item_id string
El ID del elemento de mensaje.
output_index integer
El índice del elemento de salida de la respuesta. Este valor siempre es 0.
content_index integer
El índice de la parte de contenido dentro del elemento de salida de la respuesta. Este valor siempre es 0.
part object
La parte de contenido completada.
Propiedades
type string
El tipo de la parte de contenido.
text string
El 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_id string
El ID del evento del lado del servidor.
type string
El tipo de evento. Este valor siempre es response.output_item.done.
response_id string
El ID de la respuesta.
output_index integer
El índice del elemento de salida de la respuesta. Este valor siempre es 0.
item object
Los detalles del elemento de salida.
Propiedades
id string
El ID del elemento de salida.
object string
Este valor siempre es realtime.item.
status string
El estado del elemento de salida.
content array
El 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_id string
El ID del evento del lado del servidor.
type string
El tipo de evento. Este valor siempre es response.audio.done.
response_id string
El ID de la respuesta.
item_id string
El ID del elemento de mensaje.
output_index integer
El índice del elemento de salida de la respuesta. Este valor siempre es 0.
content_index integer
El í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_id string
El ID del evento del lado del servidor.
type string
El tipo de evento. Este valor siempre es response.done.
response_id string
El ID de la respuesta.
response object
Los detalles de la respuesta.
Propiedades
id string
El ID de respuesta.
object string
El tipo de objeto. Este valor siempre es realtime.response.
output array
Salida de la respuesta.
usage object
Información de facturación para esta solicitud de síntesis de voz.
Propiedades
characters integer
El número de caracteres facturados para Qwen3-TTS Realtime.
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_id string
El ID del evento del lado del servidor.
type string
El tipo de evento. Este valor siempre es session.finished.
{
"event_id": "event_2239",
"type": "session.finished"
}