WebSocket API

Panduan pengguna: Untuk ikhtisar model dan panduan pemilihan, lihat Speech-to-text. Untuk contoh kode, lihat Real-time speech recognition. SDK DashScope saat ini hanya mendukung Java dan Python. Untuk bahasa lain, lakukan koneksi langsung ke layanan melalui WebSocket.

​

Titik akhir layanan

Paraformer hanya tersedia di wilayah China (Beijing). URL WebSocket bersifat tetap: wss://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api-ws/v1/inference Ganti {WorkspaceId} dengan workspace ID Anda yang sebenarnya.

​

Header permintaan

Tambahkan bidang berikut ke header permintaan:

Parameter	Tipe	Wajib	Deskripsi
Authorization	string	Ya	Token autentikasi dalam format Bearer <your_api_key>. Ganti <your_api_key> dengan Kunci API Anda.
user-agent	string	Tidak	Identifikasi klien. Membantu server mengenali sumber permintaan masuk.
X-DashScope-WorkSpace	string	Tidak	Alibaba Cloud Model Studio ID ruang kerja.
X-DashScope-DataInspection	string	Tidak	Apakah akan mengaktifkan inspeksi data. Abaikan header ini secara default; atur ke enable hanya jika diperlukan.

​

Alur interaksi

Untuk detail tentang event sisi klien dan sisi server, lihat Client events dan Server-sent events. Klien dan server berinteraksi dalam urutan berikut:

1. Membuat koneksi: Klien membuka koneksi WebSocket ke server.
2. Memulai tugas: Klien mengirim instruksi run-task. Server membalas dengan event task-started untuk mengonfirmasi bahwa tugas telah dimulai, setelah itu langkah-langkah berikutnya dapat dilanjutkan.
3. Mengirim aliran audio: Klien mengalirkan audio biner mono. Server mengembalikan event result-generated yang berisi hasil pengenalan.
4. Memberi tahu server untuk mengakhiri tugas: Klien mengirim instruksi finish-task dan terus menerima event result-generated dari server.
5. Mengakhiri tugas: Klien menerima event task-finished dari server, yang menandakan bahwa tugas telah berakhir.
6. Menutup koneksi: Klien menutup koneksi WebSocket.