Skip to main content
Sintesis Suara Real-Time (Qwen-TTS-Realtime)

Server-Side Events

Topik ini menjelaskan event sisi server untuk API Qwen-TTS-Realtime.

Untuk informasi selengkapnya, lihat Real-Time Speech Synthesis with Qwen.

error

Server merespons event ini baik untuk error sisi klien maupun sisi server.
event_idstringID event sisi server.typestringJenis event. Nilai ini selalu error.errorobjectDetail kesalahan.

Properties

codestringKode kesalahan.messagestringPesan kesalahan.
{
  "event_id": "event_QzAVZRVa9hKqM5VOaHunh",
  "type": "error",
  "error": {
    "code": "invalid_value",
    "message": "Session update error: session already started or finished or failed."
  }
}

session.created

Server mengirimkan event ini sebagai respons pertama setelah klien terhubung. Event ini mencakup konfigurasi default untuk sesi tersebut.
event_idstringID event sisi server.typestringJenis event. Nilai ini selalu session.created.sessionobjectKonfigurasi sesi.

Properties

idstringID sesi.objectstringNama layanan sesi.modestringMode interaksi. Nilai yang valid adalah server_commit atau commit.modelstringModel yang digunakan.voicestringVoice yang digunakan.response_formatstringFormat audio.sample_rateintegerLaju pengambilan sampel audio.
{
  "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"
  }
}

session.updated

Server mengirimkan event ini setelah menerima dan berhasil memproses permintaan session.update dari klien. Jika terjadi error, server akan mengirimkan event error sebagai gantinya.
event_idstringID event sisi server.typestringJenis event. Nilai ini selalu session.updated.sessionobjectKonfigurasi sesi.

Properties

idstringID sesi.objectstringNama layanan sesi.modestringMode interaksi. Nilai yang valid adalah server_commit atau commit.modelstringModel yang digunakan.voicestringTimbre yang digunakan.response_formatstringFormat audio.sample_rateintegerLaju pengambilan sampel audio.language_typestringBahasa audio.
{
  "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
  }
}

input_text_buffer.committed

Server mengirimkan event ini setelah menerima event input_text_buffer.commit dari klien.
event_idstringID event sisi server.typestringJenis event. Nilai ini selalu input_text_buffer.committed.item_idstringID item pesan pengguna yang akan dibuat.
{
  "event_id": "event_FC6MA88wS2oEeXkPvWsxX",
  "type": "input_text_buffer.committed",
  "item_id": ""
}

input_text_buffer.cleared

Event respons server setelah klien mengirimkan event input_audio_buffer.clear.
event_idstringID event sisi server.typestringJenis event. Nilai ini selalu input_text_buffer.cleared.
{
    "event_id": "event_1122",
    "type": "input_text_buffer.cleared"
}

response.created

Server mengirimkan event ini setelah menerima event input_text_buffer.commit dari klien.
event_idstringID event sisi server.typestringJenis event. Nilai ini selalu response.created.responseobjectDetail respons.

Properties

idstringID respons.objectstringJenis objek. Nilai ini selalu realtime.response.statusstringStatus akhir respons. Nilai yang valid adalah:
  • completed
  • failed
  • in_progress
  • incomplete
voicestringVoice yang digunakan.outputarrayBidang ini kosong untuk event ini.
{
  "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

Server mengirimkan event ini ketika output item baru siap.
event_idstringID event sisi server.typestringJenis event. Nilai ini selalu response.output_item.added.response_idstringID respons.output_indexintegerIndeks output item respons. Nilai ini selalu 0.itemobjectDetail output item.

Properties

idstringID output item.objectstringNilai ini selalu realtime.item.statusstringStatus output item.contentarrayKonten pesan.
{
  "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

Server mengirimkan event ini ketika content part baru siap.
event_idstringID event sisi server.typestringJenis event. Nilai ini selalu response.content_part.added.response_idstringID respons.item_idstringID item pesan.output_indexintegerIndeks output item respons. Nilai ini selalu 0.content_indexintegerIndeks content part dalam output item respons. Nilai ini selalu 0.partobjectContent part yang telah selesai.

Properties

typestringJenis content part.textstringTeks content part.
{
  "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

Server mengirimkan event ini ketika model menghasilkan data audio secara inkremental.
event_idstringID event sisi server.typestringJenis event. Nilai ini selalu response.audio.delta.response_idstringID respons.item_idstringID item pesan.output_indexintegerIndeks output item respons. Nilai ini selalu 0.content_indexintegerIndeks content part dalam output item respons. Nilai ini selalu 0.deltastringData audio yang dihasilkan secara inkremental oleh model. Data tersebut dikodekan dalam 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

Server mengirimkan event ini ketika content part telah selesai.
event_idstringID event sisi server.typestringJenis event. Nilai ini selalu response.content_part.done.response_idstringID respons.item_idstringID item pesan.output_indexintegerIndeks output item respons. Nilai ini selalu 0.content_indexintegerIndeks content part dalam output item respons. Nilai ini selalu 0.partobjectContent part yang telah selesai.

Properties

typestringJenis content part.textstringTeks content part.
{
  "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

Server mengirimkan event ini ketika output item telah selesai.
event_idstringID event sisi server.typestringJenis event. Nilai ini selalu response.output_item.done.response_idstringID respons.output_indexintegerIndeks output item respons. Nilai ini selalu 0.itemobjectDetail output item.

Properties

idstringID output item.objectstringNilai ini selalu realtime.item.statusstringStatus output item.contentarrayKonten pesan.
{
  "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

Server mengirimkan event ini ketika model telah selesai menghasilkan data audio.
event_idstringID event sisi server.typestringJenis event. Nilai ini selalu response.audio.done.response_idstringID respons.item_idstringID item pesan.output_indexintegerIndeks output item respons. Nilai ini selalu 0.content_indexintegerIndeks content part dalam output item respons. Nilai ini selalu 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

Server mengirimkan event ini ketika pembuatan respons telah selesai. Objek response dalam event ini berisi semua output item tetapi tidak mencakup data audio mentah yang telah dikirim sebelumnya.
event_idstringID event sisi server.typestringJenis event. Nilai ini selalu response.done.response_idstringID respons.responseobjectDetail respons.

Properties

idstringID respons.objectstringJenis objek. Nilai ini selalu realtime.response.outputarrayOutput respons.usageobjectInformasi penagihan untuk permintaan sintesis suara ini.

Properties

charactersintegerJumlah karakter yang ditagih untuk Qwen3-TTS Realtime.total_tokensintegerTotal jumlah token untuk input dan output (audio tersintesis) Qwen-TTS Realtime.input_tokensintegerJumlah token untuk konten input Qwen-TTS Realtime.output_tokensintegerJumlah token untuk konten output Qwen-TTS Realtime.input_tokens_detailsintegerRincian jumlah token untuk konten input Qwen-TTS Realtime.input_tokens_details.text_tokensintegerJumlah token untuk konten teks input Qwen-TTS Realtime.output_tokens_detailsintegerRincian jumlah token untuk konten output Qwen-TTS Realtime.output_tokens_details.text_tokensintegerJumlah token untuk konten teks output Qwen-TTS Realtime.output_tokens_details.audio_tokensintegerJumlah token untuk konten audio output Qwen-TTS Realtime.Aturan konversi audio ke token: Setiap detik audio setara dengan 50 token. Audio yang durasinya kurang dari satu detik dihitung sebagai 50 token.
{
    "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

Server mengirimkan event ini ketika semua respons telah dihasilkan.
event_idstringID event sisi server.typestringJenis event. Nilai ini selalu session.finished.
{
  "event_id": "event_2239",
  "type": "session.finished"
}
Penggunaan API
Generasi teks
Pembuatan Gambar
  • FAQ
Video Generation
Model Dunia
Audio
  • Pembuatan audio
Real-time multimodal
Realtime API
Penyematan Teks
Lainnya Model
Toolkit/Framework
TokenPlan
Model production
Manajemen file
Penagihan
Manajemen Model
Lebih Banyak Tentang Model