Referensi peristiwa server Qwen-Audio-ASR-Streaming: 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.
- 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 dihasilkan oleh klien (dalam format UUID).
eventstringJenis event. Nilai ini selalu
task-started.attributesobjectAtribut tambahan. Nilai ini biasanya kosong.
payloadobjectNilai ini selalu
{}.Permintaan:
Respons:
result-generated
Mengembalikan hasil pengenalan, termasuk awal kalimat, hasil sementara, hasil akhir kalimat, dan heartbeat.
headerobjecttask_idstringID tugas yang dihasilkan oleh klien (dalam format UUID).
eventstringJenis event. Nilai ini selalu
result-generated.payloadobjectoutputobjectsentenceobjectsentence_idintegerIdentifikasi urutan kalimat. Pada hasil pengenalan normal,
sentence_id bertambah dari 1. Ketika heartbeat bernilai true (yaitu, paket heartbeat), sentence_id selalu 0.begin_timeintegerWaktu mulai kalimat, dalam milidetik.
end_timeinteger | nullWaktu akhir kalimat, dalam milidetik. Dapat bernilai
null pada hasil sementara atau heartbeat.textstringTeks yang dikenali.
sentence_beginbooleanMenunjukkan awal sebuah kalimat.
sentence_endbooleanApakah kalimat telah berakhir (
true = hasil akhir, false = hasil antara).heartbeatbooleanJika nilai ini
true, hasil tersebut merupakan 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 untuk tugas saat ini.
usage berisi penggunaan kumulatif tugas saat ini dan mungkin tidak ada pada sebagian hasil sementara. Jangan menjumlahkan usage antarperistiwa. qwen-audio-3.0-asr-flash-streaming ditagih berdasarkan durasi dan qwen-audio-3.1-asr-flash-streaming berdasarkan token. Lihat cakupan pada deskripsi bidang.durationintegerDurasi audio kumulatif, dalam detik.
Digunakan untuk penagihan qwen-audio-3.0-asr-flash-streaming.
input_tokensintegerJumlah token input kumulatif.
Berlaku untuk qwen-audio-3.1-asr-flash-streaming.
output_tokensintegerJumlah token output kumulatif.
Berlaku untuk qwen-audio-3.1-asr-flash-streaming.
total_tokensintegerJumlah total token kumulatif, yaitu jumlah token input dan output.
Berlaku untuk qwen-audio-3.1-asr-flash-streaming.
- Awal kalimat
- Hasil sementara
- Hasil akhir kalimat
- Heartbeat
Setelah menerima
task-started, kirim audio. Contoh berikut adalah satu peristiwa result-generated yang kemudian dikembalikan server. Audio dikirim melalui frame biner WebSocket atau Audio Track AOQ.Permintaan:
Respons:
task-finished
Menunjukkan bahwa pemrosesan tugas selesai. Semua hasil pengenalan tugas telah dikembalikan.
headerobjecttask_idstringID tugas yang dihasilkan oleh klien (dalam format UUID).
eventstringJenis event. Nilai ini selalu
task-finished.attributesobjectAtribut tambahan. Nilai ini biasanya kosong.
payloadobjectusageobjectPenggunaan kumulatif pada akhir tugas. Arti bidang sama dengan
result-generated.usage.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 dihasilkan oleh klien (dalam format UUID).
eventstringJenis event. Nilai ini selalu
task-failed.error_codestringDeskripsi jenis error.
error_messagestringPenyebab spesifik dari error tersebut.
attributesobjectAtribut tambahan. Nilai ini biasanya kosong.
payloadobjectNilai ini selalu
{}.Permintaan ini menggunakan format audio yang tidak didukung untuk menunjukkan
task-failed. Kode dan pesan kesalahan bergantung pada penyebab kegagalan.Permintaan:
Respons: