Accédez au service de reconnaissance vocale en temps réel Paraformer via une connexion WebSocket. Cette rubrique décrit les endpoints du service, les en-têtes de requête et le flux d'interaction.
Endpoints du service
Paraformer est disponible exclusivement dans la région Chine (Pékin). L'URL WebSocket est fixe :
wss://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api-ws/v1/inference
Remplacez {WorkspaceId} par votre ID d'espace de travail.
En-têtes de requête
Ajoutez les champs suivants à l'en-tête de la requête :
Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
Authorization | string | Oui | Jeton d'authentification au format |
user-agent | string | Non | Identifiant du client. Permet au serveur d'identifier l'origine des requêtes entrantes. |
X-DashScope-WorkSpace | string | Non | ID d'espace de travail Alibaba Cloud Model Studio. |
X-DashScope-DataInspection | string | Non | Indique s'il faut activer l'inspection des données. Omettez cet en-tête par défaut ; définissez-le sur |
Flux d'interaction
Pour plus de détails sur les événements côté client et côté serveur, consultez les rubriques Événements client et Événements envoyés par le serveur.
- Établir la connexion : le client ouvre une connexion WebSocket vers le serveur.
- Démarrer la tâche : le client envoie une instruction run-task. Le serveur répond par un événement task-started pour confirmer le démarrage, ce qui permet d'enchaîner les étapes suivantes.
- Transmettre le flux audio : le client diffuse un flux audio binaire mono. Le serveur renvoie des événements result-generated contenant les résultats de la reconnaissance.
- Signaler la fin de la tâche au serveur : le client envoie une instruction finish-task tout en continuant à recevoir les événements result-generated du serveur.
- Terminer la tâche : le client reçoit un événement task-finished du serveur, indiquant que la tâche est terminée.
- Fermer la connexion : le client clôture la connexion WebSocket.