Skip to main content
Referência da API de síntese de fala em tempo real (Qwen-TTS-Realtime)

Server events

Eventos de servidor da API Qwen-TTS-Realtime.

Referência: Síntese de fala em tempo real .

error

Enviado para erros no lado do cliente e do servidor.
event_idstringID do evento no lado do servidor.
{
  "event_id": "event_QzAVZRVa9hKqM5VOaHunh",
  "type": "error",
  "error": {
    "code": "invalid_value",
    "message": "Session update error: session already started or finished or failed."
  }
}
typestringTipo do evento. Sempre error.
errorobjectDetalhes do erro.

Properties

codestringCódigo do erro.messagestringMensagem de erro.

session.created

Enviado quando um cliente se conecta. Inclui a configuração padrão da sessão.
event_idstringID do evento no lado do servidor.
{
  "event_id": "event_xxx",
  "type": "session.created",
  "session": {
    "object": "realtime.session",
    "mode": "server_commit",
    "model": "qwen-tts-realtime",
    "voice": "Cherry",
    "response_format": "pcm",
    "sample_rate": 24000,
    "id": "sess_xxx"
  }
}
typestringTipo do evento. Sempre session.created.
sessionobjectConfiguração da sessão.

Properties

idstringID da sessão.objectstringNome do serviço de sessão.modestringModo de interação. Valores válidos: server_commit ou commit.modelstringModelo em uso.voicestringVoz em uso.response_formatstringFormato de áudio.sample_rateintegerTaxa de amostragem do áudio.

session.updated

Enviado após o servidor processar com sucesso uma solicitação session.update. Em caso de erro, um evento error é enviado em seu lugar.
event_idstringID do evento no lado do servidor.
{
  "event_id": "event_xxx",
  "type": "session.updated",
  "session": {
    "id": "sess_xxx",
    "object": "realtime.session",
    "model": "qwen-tts-realtime",
    "voice": "Cherry",
    "language_type": "Chinese",
    "mode": "commit",
    "response_format": "pcm",
    "sample_rate": 24000
  }
}
typestringTipo do evento. Sempre session.updated.
sessionobjectConfiguração da sessão.

Properties

idstringID da sessão.objectstringNome do serviço de sessão.modestringModo de interação. Valores válidos: server_commit ou commit.modelstringModelo em uso.voicestringVoz em uso.response_formatstringFormato de áudio.sample_rateintegerTaxa de amostragem do áudio.language_typestringIdioma do áudio.

input_text_buffer.committed

Enviado após o servidor receber um evento input_text_buffer.commit.
event_idstringID do evento no lado do servidor.
{
  "event_id": "event_FC6MA88wS2oEeXkPvWsxX",
  "type": "input_text_buffer.committed",
  "item_id": ""
}
typestringTipo do evento. Sempre input_text_buffer.committed.
item_idstringID do item de mensagem do usuário a ser criado.

input_text_buffer.cleared

Resposta do servidor após o cliente enviar o evento input_text_buffer.clear.
event_idstringID do evento no lado do servidor.
{
    "event_id": "event_1122",
    "type": "input_text_buffer.cleared"
}
typestringTipo do evento. Sempre input_text_buffer.cleared.

response.created

Enviado pelo servidor após receber um evento input_text_buffer.commit do cliente.
event_idstringID do evento no lado do servidor.
{
  "event_id": "event_IMnLqDvG6Ahhk7sWV2uOs",
  "type": "response.created",
  "response": {
    "id": "resp_USvBwHktHcz76r6GaIJUV",
    "object": "realtime.response",
    "conversation_id": "",
    "status": "in_progress",
    "voice": "Cherry",
    "output": []
  }
}
typestringTipo do evento. Sempre response.created.
responseobjectDetalhes da resposta.

Properties

idstringID da resposta.objectstringTipo de objeto. Sempre realtime.response.statusstringStatus final da resposta. Valores válidos:
  • completed
  • failed
  • in_progress
  • incomplete
voicestringVoz em uso.outputarrayCampo vazio para este evento.

response.output_item.added

Enviado quando um novo item de saída está pronto.
event_idstringID do evento no lado do servidor.
{
  "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": []
  }
}
typestringTipo do evento. Sempre response.output_item.added.
response_idstringID da resposta.
output_indexintegerÍndice do item de saída da resposta. Sempre 0.
itemobjectDetalhes do item de saída.

Properties

idstringID do item de saída.objectstringSempre realtime.item.statusstringStatus do item de saída.contentarrayConteúdo da mensagem.

response.content_part.added

Enviado quando uma nova parte de conteúdo está pronta.
event_idstringID do evento no lado do servidor.
{
  "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": ""
  }
}
typestringTipo do evento. Sempre response.content_part.added.
response_idstringID da resposta.
item_idstringID do item de mensagem.
output_indexintegerÍndice do item de saída da resposta. Sempre 0.
content_indexintegerÍndice da parte de conteúdo no item de saída da resposta. Sempre 0.
partobjectParte de conteúdo concluída.

Properties

typestringTipo da parte de conteúdo.textstringTexto da parte de conteúdo.

response.audio.delta

Enviado quando o modelo gera novos dados de áudio incrementalmente.
event_idstringID do evento no lado do servidor.
{
  "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"
}
typestringTipo do evento. Sempre response.audio.delta.
response_idstringID da resposta.
item_idstringID do item de mensagem.
output_indexintegerÍndice do item de saída da resposta. Sempre 0.
content_indexintegerÍndice da parte de conteúdo no item de saída da resposta. Sempre 0.
deltastringDados de áudio gerados incrementalmente pelo modelo, codificados em Base64.

response.content_part.done

Enviado quando uma parte de conteúdo é concluída.
event_idstringID do evento no lado do servidor.
{
  "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": ""
  }
}
typestringTipo do evento. Sempre response.content_part.done.
response_idstringID da resposta.
item_idstringID do item de mensagem.
output_indexintegerÍndice do item de saída da resposta. Sempre 0.
content_indexintegerÍndice da parte de conteúdo no item de saída da resposta. Sempre 0.
partobjectParte de conteúdo concluída.

Properties

typestringTipo da parte de conteúdo.textstringTexto da parte de conteúdo.

response.output_item.done

Enviado quando um item de saída é concluído.
event_idstringID do evento no lado do servidor.
{
  "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": ""
      }
    ]
  }
}
typestringTipo do evento. Sempre response.output_item.done.
response_idstringID da resposta.
output_indexintegerÍndice do item de saída da resposta. Sempre 0.
itemobjectDetalhes do item de saída.

Properties

idstringID do item de saída.objectstringSempre realtime.item.statusstringStatus do item de saída.contentarrayConteúdo da mensagem.

response.audio.done

Enviado quando o modelo termina de gerar dados de áudio.
event_idstringID do evento no lado do servidor.
{
  "event_id": "event_LZaOHPzXYMUXGBcVkBmKX",
  "type": "response.audio.done",
  "response_id": "resp_USvBwHktHcz76r6GaIJUV",
  "item_id": "item_FIrYGaNVK3rbIZqeY4QjM",
  "output_index": 0,
  "content_index": 0
}
typestringTipo do evento. Sempre response.audio.done.
response_idstringID da resposta.
item_idstringID do item de mensagem.
output_indexintegerÍndice do item de saída da resposta. Sempre 0.
content_indexintegerÍndice da parte de conteúdo no item de saída da resposta. Sempre 0.

response.done

Enviado quando a geração da resposta é concluída. O objeto response contém todos os itens de saída, mas exclui os dados de áudio brutos já enviados.
event_idstringID do evento no lado do servidor.
{
    "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
        }
    }
}
typestringTipo do evento. Sempre response.done.
response_idstringID da resposta.
responseobjectDetalhes da resposta.

Properties

idstringID da resposta.objectstringTipo de objeto. Sempre realtime.response.outputarraySaída da resposta.usageobjectInformações de faturamento desta solicitação de síntese de fala.

Properties

charactersintegerNúmero de caracteres faturados para o Qwen3-TTS Realtime.total_tokensintegerTotal de tokens de entrada e saída (áudio sintetizado).input_tokensintegerTokens do conteúdo de entrada.output_tokensintegerTokens do conteúdo de saída.input_tokens_detailsintegerDetalhamento dos tokens de entrada.input_tokens_details.text_tokensintegerTokens do texto de entrada.output_tokens_detailsintegerDetalhamento dos tokens de saída.output_tokens_details.text_tokensintegerTokens do texto de saída.output_tokens_details.audio_tokensintegerTokens do áudio de saída.Regra de conversão de áudio para token: 1 segundo = 50 tokens. Áudios com menos de 1 segundo contam como 50 tokens.

session.finished

Enviado quando todas as respostas são geradas.
event_idstringID do evento no lado do servidor.
{
  "event_id": "event_2239",
  "type": "session.finished"
}
typestringTipo do evento. Sempre session.finished.
Uso da API
Referência da API de Geração de Texto
Geração de Imagens
  • FAQ
Geração de Vídeo
Áudio
Multimodal em Tempo Real
API em tempo real
Incorporação de Texto
Mais Modelos
Toolkit/Framework
Produção de Modelos
File Management
Gerenciamento de modelos
Mais
Server events - Alibaba Cloud Model Studio