Topik ini menjelaskan titik akhir layanan, header permintaan, dan alur interaksi untuk mengakses layanan pengenalan ucapan real-time Qwen-Audio-3.0-ASR-Flash-Streaming/Fun-ASR-Realtime melalui koneksi WebSocket.
Panduan pengguna: Untuk deskripsi 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 pemrograman lainnya, lakukan koneksi langsung ke layanan melalui WebSocket.
Titik akhir layanan
URL WebSocket bersifat tetap:
Singapore
wss://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api-ws/v1/inference
Ganti {WorkspaceId} dengan Workspace ID Anda yang sebenarnya.
China (Beijing)
wss://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api-ws/v1/inference
Ganti {WorkspaceId} dengan Workspace ID Anda yang sebenarnya.
PentingAlibaba Cloud Model Studio telah merilis domain khusus ruang kerja untuk wilayah China (Beijing) dan Singapore. Domain khusus baru ini memberikan performa lebih unggul dan stabilitas lebih tinggi untuk permintaan inferensi. Kami merekomendasikan migrasi ke domain baru berikut:
- China (Beijing): dari
dashscope.aliyuncs.comke{WorkspaceId}.cn-beijing.maas.aliyuncs.com - Singapore: dari
dashscope-intl.aliyuncs.comke{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com
Ganti {WorkspaceId} dengan Workspace ID Anda yang sebenarnya. Domain lama tetap berfungsi sepenuhnya.
PentingURL harus menggunakan protokol wss:// dan bersifat tetap. Atur Authorization di header permintaan (lihat Request headers).
Header permintaan
Tambahkan informasi berikut ke header permintaan:
Parameter | Type | Required | Description |
|---|---|---|---|
Authorization | string | Yes | Token autentikasi dalam format |
user-agent | string | No | Identifier client yang membantu server melacak sumber permintaan. |
X-DashScope-WorkSpace | string | No | Model Studio ID ruang kerja. |
X-DashScope-DataInspection | string | No | Apakah inspeksi kepatuhan data diaktifkan. Parameter ini secara default diabaikan atau diatur ke |
PentingAuthorization diverifikasi selama handshake WebSocket. Jika Kunci API tidak valid atau tidak ada, handshake gagal dan mengembalikan error HTTP 401 atau 403.
Alur interaksi
Untuk detail tentang event client dan event server, lihat Client events dan Server-side events.
Client dan server berinteraksi dalam urutan berikut:
- Membuat koneksi: Client membuat koneksi WebSocket ke server.
- Memulai task: Client mengirim instruksi run-task untuk memulai task dan menerima event task-started dari server. Event ini mengonfirmasi bahwa task telah dimulai dan Anda dapat melanjutkan ke langkah berikutnya.
- Mengirim aliran audio: Client mulai mengirim audio biner (harus mono) dan secara bersamaan menerima aliran event result-generated dari server. Setiap event berisi hasil pengenalan ucapan.
- Memberi tahu server untuk mengakhiri task: Client mengirim instruksi finish-task untuk memberi sinyal ke server agar mengakhiri task dan terus menerima event result-generated dari server.
- Mengakhiri task: Client menerima event task-finished dari server, yang menandakan bahwa task telah berakhir.
- Menutup koneksi: Client menutup koneksi WebSocket.