Skip to main content
Qwen-Audio-TTS

Server-side events Qwen-Audio-TTS

task-started

Setelah klien mengirim perintah run-task, server mengembalikan event task-started untuk menandakan bahwa tugas telah dimulai. Klien hanya dapat mengirim perintah berikutnya setelah menerima event ini.
header.task_id stringID tugas yang dihasilkan oleh klien.header.event stringJenis event. Nilai tetap: task-started.payload objectObjek kosong.
{
  "header": {
    "task_id": "2bf83b9a-baeb-4fda-8d9a-xxxxxxxxxxxx",
    "event": "task-started",
    "attributes": {}
  },
  "payload": {}
}

result-generated

Setelah klien mengirim teks, server terus-menerus mengembalikan event result-generated. Setiap event membawa metadata tingkat kalimat.
header.task_id stringID tugas yang dihasilkan oleh klien.header.event stringJenis event. Nilai tetap: result-generated.payload.output objectInformasi output.

Properti

type stringJenis sub-event. Nilai yang valid:
  • sentence-begin: Awal kalimat. Mengembalikan teks yang akan disintesis.
  • sentence-synthesis: Menandai satu frame audio. Satu frame audio dikirimkan melalui saluran biner WebSocket segera setelah setiap event.
  • sentence-end: Akhir kalimat. Mengembalikan konten teks dan informasi penggunaan (usage).
sentence.index integerIndeks kalimat, dimulai dari 0.sentence.words arrayArray timestamp tingkat kata.

Properti elemen words

text stringKonten teks kata tersebut.begin_index integerIndeks karakter awal kata dalam kalimat. Dimulai dari 0.end_index integerIndeks karakter akhir kata dalam kalimat. Dimulai dari 1.begin_time integerWaktu mulai audio yang sesuai dengan kata tersebut, dalam milidetik.end_time integerWaktu akhir audio yang sesuai dengan kata tersebut, dalam milidetik.
original_text stringTeks kalimat sebagaimana telah disegmentasi untuk sintesis.
payload.usage objectPenggunaan untuk penagihan, dikembalikan dalam event sentence-end.

Properti

input_tokens integerJumlah token input untuk permintaan ini.
Berlaku untuk qwen-audio-3.1-tts-flash.
output_tokens integerJumlah token output untuk permintaan ini.
Berlaku untuk qwen-audio-3.1-tts-flash.
total_tokens integerJumlah token input dan output.
Berlaku untuk qwen-audio-3.1-tts-flash.
characters integerJumlah kumulatif karakter yang ditagih.
Berlaku untuk qwen-audio-3.0-tts-plus dan qwen-audio-3.0-tts-flash.
{
  "header": {
    "task_id": "3f2d5c86-0550-45c0-801f-xxxxxxxxxx",
    "event": "result-generated",
    "attributes": {}
  },
  "payload": {
    "output": {
      "sentence": {
        "index": 0,
        "words": []
      },
      "type": "sentence-begin",
      "original_text": "Before my bed, moonlight shines bright,"
    }
  }
}

task-finished

Server mengembalikan event task-finished ketika tugas selesai. Klien kemudian dapat menutup koneksi WebSocket atau menggunakannya kembali untuk memulai tugas baru.
header.task_id stringID tugas yang dihasilkan oleh klien.header.event stringJenis event. Nilai tetap: task-finished.payload.usage objectField sama dengan usage di result-generated.
{
  "header": {
    "task_id": "2bf83b9a-baeb-4fda-8d9a-xxxxxxxxxxxx",
    "event": "task-finished",
    "attributes": {
      "request_uuid": "0a9dba9e-d3a6-45a4-be6d-xxxxxxxxxxxx"
    }
  },
  "payload": {
    "usage": {
      "characters": 13
    }
  }
}

task-failed

Server mengembalikan event task-failed ketika tugas gagal. Saat menerima event ini, klien harus menutup koneksi WebSocket dan menangani kesalahan tersebut.
header.task_id stringID tugas yang dihasilkan oleh klien.header.event stringJenis event. Nilai tetap: task-failed.header.error_code stringKode kesalahan.header.error_message stringPesan kesalahan detail.
{
  "header": {
    "task_id": "2bf83b9a-baeb-4fda-8d9a-xxxxxxxxxxxx",
    "event": "task-failed",
    "error_code": "InvalidParameter",
    "error_message": "[tts:]Engine return error code: 418",
    "attributes": {}
  },
  "payload": {}
}
Penggunaan API
Generasi teks
Pembuatan Gambar
  • FAQ
Video Generation
Model Dunia
Audio
Real-time multimodal
Realtime API
Penyematan Teks
Lainnya Model
Toolkit/Framework
TokenPlan
Model production
Manajemen file
Penagihan
Manajemen Model
Lebih Banyak Tentang Model