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.
ImportantAlibaba Cloud Model Studio a publié un domaine spécifique à l'espace de travail pour la région Chine (Pékin). Ce nouveau domaine dédié offre des performances supérieures et une stabilité accrue pour les requêtes d'inférence. Nous vous recommandons de migrer de dashscope.aliyuncs.com vers {WorkspaceId}.cn-beijing.maas.aliyuncs.com.
Remplacez {WorkspaceId} par votre ID d'espace de travail. Le domaine existant reste pleinement fonctionnel.
ImportantCe document s'applique uniquement à la région Chine (Pékin). Pour utiliser des modèles, vous devez disposer d'une clé API provenant de la région Chine (Pékin).
Guide utilisateur : Pour obtenir une vue d'ensemble des modèles et des conseils de sélection, consultez la rubrique Reconnaissance vocale. Pour accéder à des exemples de code, reportez-vous à Reconnaissance vocale en temps réel.
Le SDK DashScope ne prend actuellement en charge que Java et Python. Pour les autres langages, connectez-vous directement au service via WebSocket.
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.
ImportantL'URL doit impérativement utiliser le protocole wss://. Fournissez votre clé API dans l'en-tête de requête Authorization (voir En-têtes de requête).
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 |
ImportantL'en-tête Authorization est vérifié lors de la négociation WebSocket. Si la clé API est invalide ou absente, la négociation échoue avec une erreur HTTP 401 ou 403.
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.
Le client et le serveur interagissent selon la séquence suivante :
- É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.