Akses layanan pengenalan ucapan real-time Paraformer melalui koneksi WebSocket. Topik ini menjelaskan titik akhir layanan, header permintaan, dan alur interaksi.
PentingAlibaba Cloud Model Studio telah merilis domain khusus ruang kerja untuk wilayah China (Beijing). Domain khusus baru ini menawarkan kinerja lebih unggul dan stabilitas lebih tinggi untuk permintaan inferensi. Kami menyarankan Anda bermigrasi dari dashscope.aliyuncs.com ke {WorkspaceId}.cn-beijing.maas.aliyuncs.com.
Ganti {WorkspaceId} dengan Workspace ID Anda yang sebenarnya. Domain yang ada tetap berfungsi sepenuhnya.
PentingDokumen ini hanya berlaku untuk wilayah China (Beijing). Untuk menggunakan model, Anda harus menggunakan Kunci API dari wilayah China (Beijing).
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.
PentingURL harus menggunakan protokol wss://. Sertakan Kunci API Anda dalam header permintaan Authorization (lihat Header permintaan).
Header permintaan
Tambahkan bidang berikut ke header permintaan:
Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
Authorization | string | Ya | Token autentikasi dalam format |
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 |
PentingHeader Authorization diverifikasi selama handshake WebSocket. Jika Kunci API tidak valid atau tidak disertakan, handshake gagal dengan error HTTP 401 atau 403.
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:
- Membuat koneksi: Klien membuka koneksi WebSocket ke server.
- 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.
- Mengirim aliran audio: Klien mengalirkan audio biner mono. Server mengembalikan event result-generated yang berisi hasil pengenalan.
- Memberi tahu server untuk mengakhiri tugas: Klien mengirim instruksi finish-task dan terus menerima event result-generated dari server.
- Mengakhiri tugas: Klien menerima event task-finished dari server, yang menandakan bahwa tugas telah berakhir.
- Menutup koneksi: Klien menutup koneksi WebSocket.