Migrer du code de la version 3.2 vers la version 2024-11-15
L’API REST de reconnaissance vocale est utilisée pour la transcription rapide, la transcription par lots et la reconnaissance vocale personnalisée. Cet article décrit les changements entre la version 3.2 et la version 2024-11-15.
Important
La version 2024-11-15 de l’API REST de reconnaissance vocale est la dernière version en disponibilité générale.
- La version
2024-05-15-previewde l’API REST de reconnaissance vocale sera supprimée à une date qui sera annoncée ultérieurement. - L’API REST de reconnaissance vocale
v3.0,v3.1,v3.2,3.2-preview.1, et3.2-preview.2sera retirée le 1er avril 2026.
Pour plus d’informations sur la mise à niveau, consultez les guides de migration de l’API REST de reconnaissance vocale v3.0 vers v3.1, v3.1 vers v3.2 et v3.2 to 2024-11-15.
Chemin de base
L’API de reconnaissance vocale personnalisée est passée d’un schéma de contrôle de version basé sur un chemin d’accès à un schéma basé sur des paramètres de requête en alignement avec les schémas généraux de contrôle de version d’API Azure. Cela nécessite des modifications au chemin d’accès de base utilisé. Mettez à jour le chemin d’accès de /speechtotext/v3.2 vers /speechtotext et ajoutez la version de l’API avec ?api-version=2024-11-15 à toutes les requêtes.
Groupes de données
La propriété email et le processus de notification par e-mail connecté sont supprimés de l’API.
La propriété duration nommée duration dans les réponses de jeu de données est renommée durationMilliseconds et est désormais un nombre brut au lieu d’une chaîne au format ISO8601 (P1D2H3M4S…) pour un traitement plus simple.
Le paramètre de requête sasValidityInSeconds est renommé sasLifetimeMinutes pour obtenir des fichiers. L’utilisation n’est autorisée que pour un compte avec BYOS désactivé. Pour les comptes avec BYOS activé, les URL SAS ne sont pas retournées.
La propriété project est supprimée dans les demandes de création.
Modèles
Suppression de la propriété text dans une demande de création de modèle. L’alternative consiste à créer un jeu de données avec le contenu texte et à créer d’abord un jeu de données, qui est ensuite utilisé ultérieurement pour la création de modèle.
La propriété email et le processus de notification par e-mail connecté sont supprimés de l’API.
Le paramètre de requête sasValidityInSeconds est renommé sasLifetimeMinutes pour obtenir des fichiers. L’utilisation est uniquement autorisée pour un compte avec BYOS (apportez votre propre stockage) désactivé. Pour les comptes avec BYOS activé, les URL SAS ne sont pas retournées.
L’opération GET models/id/manifest nécessite désormais toujours une durée de vie SAS différente de zéro. La propriété sasValidityInSeconds correspondante est renommée sasLifetimeMinutes.
La propriété project est supprimée dans les demandes de création.
Évaluations
Le paramètre de requête sasValidityInSeconds est renommé sasLifetimeMinutes pour obtenir des fichiers. L’utilisation n’est autorisée que pour un compte avec BYOS désactivé. Pour les comptes avec BYOS activé, les URL SAS ne sont pas retournées.
La propriété project est supprimée dans les demandes de création
La propriété email et le processus de notification par e-mail connecté sont supprimés de l’API.
Points de terminaison
L’API permettant de récupérer et de supprimer les fichiers journaux des journaux de point de terminaison est supprimée. La reconnaissance vocale personnalisée prend désormais en charge BYOS (apportez votre propre stockage). Seuls les comptes avec BYOS activé peuvent activer la journalisation sur les points de terminaison de modèle. Cela offre une facilité de gestion complète des fichiers journaux sur le stockage client au lieu d’une API proxy.
Suppression de la prise en charge de timeToLive dans les créations de points de terminaison.
Suppression de la propriété text dans une demande de création de point de terminaison. L’alternative consiste à créer un jeu de données avec le contenu texte et à créer d’abord un jeu de données, qui est ensuite utilisé ultérieurement pour la création de modèle. Ce modèle peut ensuite être utilisé pour créer un point de terminaison.
Les liens de point de terminaison retournent désormais uniquement le point de terminaison de la connexion WebSocket, utilisé pour le SDK.
La propriété project est supprimée dans les demandes de création.
La propriété email et le processus de notification par e-mail connecté sont supprimés de l’API.
Transcriptions
Suppression de la propriété diarizationEnabled de niveau supérieur d’une transcription. La configuration de la diarisation est simplifiée pour "diarization": {"maxSpeakers": 2,"enabled": true}. La propriété maxSpeakers est facultative et la valeur par défaut est 2. La propriété enabled est requise pour la diarisation.
Création de transcription : timeToLive est renommé timeToLiveHours y compris la modification du format de la chaîne au format ISO8601 vers un ENT simple (nombre d’heures).
La propriété duration nommée duration dans les réponses de transcription est renommée durationMilliseconds et est désormais un nombre brut au lieu d’une chaîne au format ISO8601 (P1D2H3M4S…) pour un traitement plus simple. Les fichiers de résultats de transcription ont cette propriété ajoutée pour assurer la cohérence avec l’API.
Le paramètre de requête sasValidityInSeconds est renommé sasLifetimeMinutes pour obtenir des fichiers. L’utilisation n’est autorisée que pour un compte avec BYOS désactivé. Pour les comptes avec BYOS activé, les URL SAS ne sont pas retournées.
La propriété project est supprimée dans les demandes de création.
La propriété email et le processus de notification par e-mail connecté sont supprimés de l’API.
Projets
L’API de projets est supprimée.