Referensi peristiwa server Qwen-Audio-ASR-Message: bidang awal tugas, hasil pengenalan, penyelesaian, kegagalan, dan permintaan terkait.
Alur peristiwa
- Kirim run-task. Tunggu task-started sebelum mengirim audio.
- Terus kirim audio sambil menerima peristiwa result-generated.
- Selama tugas berlangsung, gunakan continue-task untuk memperbarui konteks percakapan. Audio tetap dikirim melalui saluran audio.
- Setelah semua audio terkirim, kirim finish-task dan terima hasil hingga task-finished diterima. Tugas yang gagal mengembalikan task-failed.
run-task: WebSocket menggunakan frame biner, sedangkan AOQ menggunakan Audio Track. Untuk koneksi, autentikasi, dan transmisi audio, lihat API WebSocket atau akses AOQ.
task-started
Menunjukkan bahwa tugas berhasil dimulai dan klien dapat mulai mengirim audio.
headerobjecttask_idstringID tugas yang dibuat klien, dalam format UUID.
eventstringJenis peristiwa. Nilainya selalu
task-started.attributesobjectAtribut tambahan, biasanya kosong.
payloadobjectNilainya selalu
{}.Permintaan:
Respons:
result-generated
Mengembalikan hasil pengenalan, termasuk awal kalimat, hasil sementara, hasil akhir kalimat, dan heartbeat. Hasil sementara dinonaktifkan secara default; atur intermediate_result_enabled=true untuk mengaktifkannya.
headerobjecttask_idstringID tugas yang dibuat klien, dalam format UUID.
eventstringJenis peristiwa. Nilainya selalu
result-generated.payloadobjectoutputobjectsentenceobjectsentence_idintegerNomor urut kalimat. Dalam hasil normal,
sentence_id bertambah mulai dari 1. Jika heartbeat bernilai true (paket heartbeat), sentence_id selalu 0.begin_timeintegerWaktu mulai kalimat, dalam milidetik.
end_timeintegerWaktu akhir kalimat, dalam milidetik.Dapat bernilai
null pada hasil sementara atau heartbeat.textstringTeks yang dikenali.
Teks sementara dapat berubah selama pengenalan berlangsung. Perbarui teks yang ditampilkan untuk
sentence_id yang sama, bukan menggabungkan teks sementara secara langsung.sentence_beginbooleanNilai
true menunjukkan awal kalimat. Bidang text dapat kosong pada saat ini.sentence_endbooleanMenentukan apakah kalimat telah selesai (
true: hasil akhir, false: hasil sementara).heartbeatbooleanJika nilainya
true, hasil adalah paket heartbeat dan dapat diabaikan.wordsarray[object]Informasi timestamp tingkat kata.
begin_timeintegerWaktu mulai kata, dalam milidetik.
end_timeintegerWaktu akhir kata, dalam milidetik.
textstringTeks yang dikenali.
punctuationstringTanda baca.
usageobjectPenggunaan kumulatif tugas saat ini hingga peristiwa ini.
usage berisi penggunaan kumulatif tugas saat ini. Jangan menjumlahkan nilai usage dari beberapa peristiwa. Setelah tugas selesai, gunakan penggunaan kumulatif akhir dalam task-finished.durationintegerDurasi 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.- Awal kalimat
- Hasil sementara
- Hasil akhir kalimat
Permintaan:
Respons:
task-finished
Pemrosesan tugas selesai dan semua hasil pengenalan telah dikembalikan. Klien dapat menutup koneksi atau menggunakannya kembali untuk memulai tugas baru.
headerobjecttask_idstringID tugas yang dibuat klien, dalam format UUID.
eventstringJenis peristiwa. Nilainya selalu
task-finished.attributesobjectAtribut tambahan, biasanya kosong.
payloadobjectBerisi
output (objek kosong) dan usage (penggunaan kumulatif akhir tugas). Bidang usage didefinisikan sama seperti pada result-generated.Permintaan:
Respons:
task-failed
Menunjukkan bahwa tugas gagal. Periksa error_code dan error_message untuk mengetahui penyebabnya. Setelah tugas gagal, koneksi WebSocket ditutup dan tidak dapat digunakan kembali.
headerobjecttask_idstringID 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.
payloadobjectNilainya selalu
{}.Permintaan ini menggunakan format audio yang tidak didukung untuk menunjukkan
task-failed. Kode dan pesan kesalahan bergantung pada penyebab kegagalan.Permintaan:
Respons: