Topik ini menjelaskan event klien yang dikirim oleh klien ke server melalui WebSocket dalam layanan pengenalan ucapan real-time Fun-ASR-Realtime, termasuk struktur data dan definisi bidang untuk run-task (memulai tugas), dan finish-task (mengakhiri tugas).
run-task
Memulai tugas pengenalan ucapan dan menetapkan parameter seperti model, format audio, dan laju sampel.
Kapan mengirim: Kirim segera setelah koneksi WebSocket terbentuk.
Event respons: Anda hanya dapat mengirim audio setelah server mengembalikan event task-started.
headerobject(Wajib)
Properti action string(Wajib)Jenis perintah. Tetapkan ke run-task.task_idstring(Wajib)ID tugas yang dihasilkan klien (format UUID) yang menghubungkan event berikutnya dengan tugas ini.streamingstring(Wajib)Tetapkan ke duplex.object(Wajib)
Properti task_group string(Wajib)Grup tugas. Tetapkan ke audio.taskstring(Wajib)Jenis tugas. Tetapkan ke asr.functionstring(Wajib)Jenis fungsi. Tetapkan ke recognition.modelstring(Wajib)Nama model.inputobject(Wajib)Objek input. Berikan {} jika tidak ada konteks yang disediakan.
Properti context array(object)(Opsional)Konteks percakapan meningkatkan akurasi pengenalan untuk kosakata spesifik domain. Untuk detail penggunaan, lihat Peningkatan konteks.
Properti role string(Wajib)Peran pesan. Nilai yang valid:
array(object)(Wajib)Daftar konten pesan.
Properti type string(Wajib)Jenis konten. Nilai yang valid:
string(Wajib)Isi teks. Saat type bernilai input_text, masukkan hasil pengenalan dari giliran ucapan pengguna sebelumnya atau daftar kata spesifik domain. Saat type bernilai text, masukkan tanggapan dari model bahasa besar pada giliran sebelumnya.object(Wajib)Parameter pengenalan ucapan.
Properti format string(Wajib)Format audio.Nilai yang valid:
integer(Wajib)Laju sampel, dalam Hz.Nilai yang valid: Model 8 kHz hanya mendukung 8000 Hz; model lain mendukung laju sampel apa pun.vocabulary_idstring(Opsional)ID daftar kata kunci yang telah dikompilasi sebelumnya.Hasilkan ID ini terlebih dahulu dengan memanggil API pembuatan daftar kata kunci. Berikan ID tersebut selama pengenalan untuk menggunakan kata kunci dalam daftar.Cocok untuk skenario di mana kosakata diketahui dan relatif stabil, serta Anda perlu menggunakan kembali daftar kata yang sama di berbagai permintaan.Untuk detail penggunaan, lihat Kata kunci yang telah dikompilasi.language_hintsarray[string](Opsional)Bahasa audio yang akan dikenali. Tidak ada nilai default; jika tidak ditetapkan, model akan mendeteksi bahasa secara otomatis.Anda dapat menetapkan 1 nilai. Jika lebih, hanya nilai pertama yang berlaku.
Klik untuk melihat kode bahasa yang didukung
integer(Opsional)Ambang batas diam VAD untuk segmentasi, dalam ms. Ketika keheningan setelah segmen ucapan melebihi ambang batas ini, sistem menentukan bahwa kalimat telah berakhir.Nilai default: 1300.Nilai yang valid: [200, 6000].multi_threshold_mode_enabledboolean(Opsional)Apakah mode multi-ambang batas diaktifkan. Saat diaktifkan, ini mencegah segmen VAD menjadi terlalu panjang.Nilai default: false.heartbeatboolean(Opsional)Apakah paket heartbeat diaktifkan.Nilai default: false.
float(Opsional)Ambang batas untuk membedakan ucapan dari kebisingan, digunakan untuk menyesuaikan sensitivitas Voice Activity Detection (VAD).Nilai yang valid: [-1.0, 1.0].Deskripsi nilai:
string(Opsional)Aturan penyaringan untuk mengganti kata tertentu dalam hasil pengenalan dengan tanda bintang dalam jumlah yang sama atau menghapusnya. Nilainya berupa string JSON hasil serialisasi objek aturan. Maksimal 32 kata sensitif dapat dikonfigurasi. Tidak ada penyaringan jika parameter dihilangkan.
|
finish-task
Memberi tahu server bahwa semua audio telah dikirim dan meminta untuk mengakhiri tugas.
Kapan mengirim: Kirim setelah semua data audio dikirim.
Event respons: Server mengembalikan event task-finished.
headerobject(Wajib)
Properti action string(Wajib)Jenis perintah. Tetapkan ke finish-task.task_idstring(Wajib)ID tugas yang dihasilkan klien (format UUID) dan harus sesuai dengan task_id dalam event run-task.streamingstring(Wajib)Tetapkan ke duplex.object(Wajib)
Properti input object(Wajib)Tetapkan ke {}. |