Layanan pengenalan ucapan real-time Qwen-Audio-ASR-Message mendorong server-side events ke klien melalui WebSocket. Topik ini menjelaskan struktur data dan deskripsi bidang dari empat jenis event: task-started, result-generated, task-finished, dan task-failed.
task-started
Tugas berhasil dimulai. Klien dapat mulai mengirim data audio.
headerobject
Properti task_id stringID tugas yang dibuat klien, dalam format UUID.eventstringJenis peristiwa. Nilainya selalu task-started.attributesobjectAtribut tambahan, biasanya kosong.objectNilainya selalu {}. |
result-generated
Hasil pengenalan. Secara default, teks akhir kalimat dikembalikan (sentence_end=true). Tetapkan intermediate_result_enabled=true untuk menerima teks sementara (sentence_end=false). Teks sementara dapat direvisi: perbarui tampilan berdasarkan sentence_id, jangan menggabungkannya. Peristiwa awal kalimat dapat berisi sentence_begin=true dan teks kosong.
headerobject
Properti task_id stringID tugas yang dibuat klien, dalam format UUID.eventstringJenis peristiwa. Nilainya selalu result-generated.object
Properti output object
Properti sentence object
Properti begin_time integerWaktu mulai kalimat, dalam milidetik.end_timeintegerWaktu akhir kalimat, dalam milidetik.textstringTeks yang dikenali.heartbeatbooleanJika nilainya true, hasil adalah paket heartbeat dan dapat diabaikan.sentence_beginbooleanMenandai awal kalimat.sentence_endbooleanMenentukan apakah kalimat telah selesai (true: hasil akhir, false: hasil sementara).sentence_idintegerNomor urut kalimat. Dalam hasil normal, sentence_id bertambah mulai dari 1. Jika heartbeat bernilai true (paket heartbeat), sentence_id selalu 0.wordsarray[object]Informasi timestamp tingkat kata.
Properti begin_time integerWaktu mulai kata, dalam milidetik.end_timeintegerWaktu akhir kata, dalam milidetik.textstringTeks yang dikenali.punctuationstringTanda baca.objectPenggunaan kumulatif tugas saat ini hingga peristiwa ini.
Properti duration integerDurasi audio kumulatif dalam detik, dipertahankan untuk kompatibilitas.input_tokensintegerJumlah kumulatif token input.output_tokensintegerJumlah kumulatif token output.total_tokensintegerJumlah total token kumulatif: penjumlahan input_tokens dan output_tokens. | Hasil awal kalimat: |
task-finished
Tugas selesai secara normal. Anda dapat menutup atau menggunakan kembali koneksi.
headerobject
Properti task_id stringID tugas yang dibuat klien, dalam format UUID.eventstringJenis peristiwa. Nilainya selalu task-finished.attributesobjectAtribut tambahan, biasanya kosong.objectBerisi output (objek kosong) dan usage (penggunaan kumulatif akhir tugas). Bidang usage didefinisikan sama seperti pada result-generated. |
task-failed
Tugas gagal. Koneksi ditutup dan tidak dapat digunakan kembali.
headerobject
Properti task_id stringID tugas yang dibuat klien, dalam format UUID.eventstringJenis peristiwa. Nilainya selalu task-failed.error_codestringDeskripsi jenis kesalahan.error_messagestringPenyebab spesifik kesalahan.attributesobjectAtribut tambahan, biasanya kosong.objectNilainya selalu {}. |