Cycle de vie des modèles vocaux personnalisés

Article
02/02/2024

Vous pouvez utiliser un modèle vocal personnalisé pendant un certain temps après que vous l’avez déployé sur votre point de terminaison personnalisé. Mais quand de nouveaux modèles sont mis à disposition, les modèles plus anciens expirent. Vous devez régulièrement recréer et entraîner votre modèle personnalisé à partir du dernier modèle de base pour profiter de l’amélioration de la précision et de la qualité.

Voici quelques termes clés liés au cycle de vie du modèle :

Entraînement : personnalisation d’un modèle de base en fonction de votre domaine/scénario à l’aide de données texte et/ou audio. Dans certains contextes comme les propriétés de l’API REST, l’entraînement est également appelé adaptation.
Transcription : utilisation d’un modèle et exécution de la reconnaissance vocale (décodage de l’audio en texte).
Point de terminaison : déploiement spécifique d’un modèle de base ou d’un modèle personnalisé auquel vous seul pouvez accéder.

Notes

Les points de terminaison utilisés par les ressources Speech F0 sont supprimés après sept jours.

Chronologie d’expiration

Voici les chronologies concernant l’adaptation de modèle et l’expiration de la transcription :

L’entraînement est disponible pendant un an après le trimestre durant lequel Microsoft a créé le modèle de base.
La transcription associée à un modèle de base est disponible pendant deux ans après le trimestre durant lequel Microsoft a créé le modèle de base.
La transcription associée à un modèle personnalisé est disponible pendant deux ans après le trimestre durant lequel vous avez créé le modèle personnalisé.

Dans ce contexte, les trimestres se terminent le 15 janvier, le 15 avril, le 15 juillet et le 15 octobre.

Actions à effectuer lorsqu’un modèle expire

Lorsqu’un modèle personnalisé ou un modèle de base expire, il n’est plus disponible pour la transcription. Vous pouvez changer le modèle utilisé par votre point de terminaison Speech personnalisé sans temps d’arrêt.

Itinéraire de transcription	Résultat du modèle expiré	Recommandation
Point de terminaison personnalisé	Les demandes de reconnaissance vocale reviennent au modèle de base le plus récent pour les mêmes paramètres régionaux. Vous allez obtenir des résultats, mais la reconnaissance peut ne pas transcrire avec précision vos données de domaine.	Mettez à jour le modèle du point de terminaison comme décrit dans le guide Déployer un modèle vocal personnalisé.
Transcription Batch	Les demandes de transcription par lots pour les modèles expirés échouent avec une erreur 4xx.	Dans chaque corps de la demande de l’API REST Transcriptions_Create, définissez la propriété `model` sur un modèle de base ou un modèle personnalisé qui n’est pas encore expiré. Sinon, n’incluez pas la propriété `model`, afin de toujours utiliser le dernier modèle de base.

Obtenir les dates d’expiration du modèle de base

La dernière date à laquelle vous pouvez utiliser le modèle de base pour la formation s’est affichée lors de la création du modèle personnalisé. Pour plus d’informations, consultez Former un modèle vocal personnalisé.

Suivez ces instructions pour obtenir la date d’expiration de la transcription pour un modèle de base :

Connectez-vous à Speech Studio.
Sélectionnez Custom Speech> Nom de votre projet >Déployer des modèles.
La date d’expiration du modèle est affichée dans la colonne Expiration. Cette date est la dernière à laquelle vous pouvez utiliser le modèle pour la transcription.

Pour obtenir les dates d’expiration de la formation et de la transcription pour un modèle de base, utilisez la commande spx csr model status. Construisez les paramètres de la requête conformément aux instructions suivantes :

Définissez le paramètre url sur l’URI du modèle de base que vous souhaitez obtenir. Vous pouvez exécuter la commande spx csr list --base pour obtenir les modèles de base disponibles pour tous les paramètres régionaux.

Voici un exemple de commande CLI Speech pour obtenir les dates d’expiration de la formation et de la transcription pour un modèle de base :

spx csr model status --api-version v3.1 --model https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/models/base/b0bbc1e0-78d5-468b-9b7c-a5a43b2bb83f

Dans la réponse, prenez note de la date dans la propriété adaptationDateTime. Cette propriété est la dernière date à laquelle vous pouvez utiliser le modèle de base pour la formation. Prenez également note de la date dans la propriété transcriptionDateTime. Cette date est la dernière à laquelle vous pouvez utiliser le modèle de base pour la transcription.

Vous devriez recevoir un corps de réponse au format suivant :

{
  "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/models/base/1aae1070-7972-47e9-a977-87e3b05c457d",
  "datasets": [],
  "links": {
    "manifest": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/models/base/1aae1070-7972-47e9-a977-87e3b05c457d/manifest"
  },
  "properties": {
    "deprecationDates": {
      "adaptationDateTime": "2023-01-15T00:00:00Z",
      "transcriptionDateTime": "2024-01-15T00:00:00Z"
    }
  },
  "lastActionDateTime": "2022-05-06T10:52:02Z",
  "status": "Succeeded",
  "createdDateTime": "2021-10-13T00:00:00Z",
  "locale": "en-US",
  "displayName": "20210831 + Audio file adaptation",
  "description": "en-US base model"
}

Pour l’aide de l’interface CLI Speech avec les modèles, exécutez la commande suivante :

spx help csr model

Pour obtenir les dates d’expiration de la formation et de la transcription pour un modèle de base, utilisez l’opération Models_GetBaseModel de l’API REST de reconnaissance vocale. Vous pouvez effectuer une requête Models_ListBaseModels pour obtenir les modèles de base disponibles pour tous les paramètres régionaux.

Effectuez une requête HTTP GET à l’aide de l’URI modèle, comme illustré dans l’exemple suivant. Remplacez BaseModelId par l’ID de votre modèle, remplacez YourSubscriptionKey par votre clé de ressource Speech et remplacez YourServiceRegion par votre région de ressource Speech.

curl -v -X GET "https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/v3.1/models/base/BaseModelId" -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey"

Dans la réponse, prenez note de la date dans la propriété adaptationDateTime. Cette date est la dernière à laquelle vous pouvez utiliser le modèle de base pour la formation. Prenez également note de la date dans la propriété transcriptionDateTime. Cette date est la dernière à laquelle vous pouvez utiliser le modèle de base pour la transcription.

Vous devriez recevoir un corps de réponse au format suivant :

{
  "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/models/base/1aae1070-7972-47e9-a977-87e3b05c457d",
  "datasets": [],
  "links": {
    "manifest": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/models/base/1aae1070-7972-47e9-a977-87e3b05c457d/manifest"
  },
  "properties": {
    "deprecationDates": {
      "adaptationDateTime": "2023-01-15T00:00:00Z",
      "transcriptionDateTime": "2024-01-15T00:00:00Z"
    }
  },
  "lastActionDateTime": "2022-05-06T10:52:02Z",
  "status": "Succeeded",
  "createdDateTime": "2021-10-13T00:00:00Z",
  "locale": "en-US",
  "displayName": "20210831 + Audio file adaptation",
  "description": "en-US base model"
}

Obtenir les dates d’expiration de modèles personnalisés

Suivez ces instructions pour obtenir la date d’expiration de la transcription pour un modèle personnalisé :

Connectez-vous à Speech Studio.
Sélectionnez Vocal personnalisé> Votre nom de projet >Former des modèles personnalisés.
La date d’expiration du modèle personnalisé est affichée dans la colonne Expiration. Cette date est la dernière à laquelle vous pouvez utiliser le modèle personnalisé pour la transcription. Les modèles de base ne sont pas affichés dans la page Former des modèles personnalisés.

Vous pouvez également suivre ces instructions pour obtenir la date d’expiration de la transcription pour un modèle personnalisé :

Connectez-vous à Speech Studio.
Sélectionnez Custom Speech> Nom de votre projet >Déployer des modèles.
La date d’expiration du modèle est affichée dans la colonne Expiration. Cette date est la dernière à laquelle vous pouvez utiliser le modèle pour la transcription.

Pour obtenir la date d’expiration de la transcription de votre modèle personnalisé, utilisez la commande spx csr model status. Construisez les paramètres de la requête conformément aux instructions suivantes :

Définissez le paramètre url sur l’URI du modèle que vous souhaitez obtenir. Remplacez YourModelId par l’ID de votre modèle et YourServiceRegion par la région de votre ressource Speech.

Voici un exemple de commande CLI Speech pour obtenir la date d’expiration de la transcription pour votre modèle personnalisé :

spx csr model status --api-version v3.1 --model https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/v3.1/models/YourModelId

Dans la réponse, prenez note de la date dans la propriété transcriptionDateTime. Cette date est la dernière à laquelle vous pouvez utiliser votre modèle personnalisé pour la transcription. La propriété adaptationDateTime n’est pas applicable, car les modèles personnalisés ne sont pas utilisés pour former d’autres modèles personnalisés.

Vous devriez recevoir un corps de réponse au format suivant :

{
  "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/models/86c4ebd7-d70d-4f67-9ccc-84609504ffc7",
  "baseModel": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/models/base/1aae1070-7972-47e9-a977-87e3b05c457d"
  },
  "datasets": [
    {
      "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/datasets/69e46263-ab10-4ab4-abbe-62e370104d95"
    }
  ],
  "links": {
    "manifest": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/models/86c4ebd7-d70d-4f67-9ccc-84609504ffc7/manifest",
    "copyTo": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/models/86c4ebd7-d70d-4f67-9ccc-84609504ffc7:copyto"
  },
  "project": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/projects/5d25e60a-7f4a-4816-afd9-783bb8daccfc"
  },
  "properties": {
    "deprecationDates": {
      "adaptationDateTime": "2023-01-15T00:00:00Z",
      "transcriptionDateTime": "2024-07-15T00:00:00Z"
    }
  },
  "lastActionDateTime": "2022-05-21T13:21:01Z",
  "status": "Succeeded",
  "createdDateTime": "2022-05-22T16:37:01Z",
  "locale": "en-US",
  "displayName": "My Model",
  "description": "My Model Description"
}

Pour l’aide de l’interface CLI Speech avec les modèles, exécutez la commande suivante :

spx help csr model

Pour obtenir la date d’expiration de la transcription de votre modèle personnalisé, utilisez l’opération Models_GetCustomModel de l’API REST de reconnaissance vocale.

Effectuez une requête HTTP GET à l’aide de l’URI modèle, comme illustré dans l’exemple suivant. Remplacez YourModelId par l’ID de votre modèle, remplacez YourSubscriptionKey par votre clé de ressource Speech et remplacez YourServiceRegion par votre région de ressource Speech.

curl -v -X GET "https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/v3.1/models/YourModelId" -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey"

Vous devriez recevoir un corps de réponse au format suivant :

{
  "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/models/86c4ebd7-d70d-4f67-9ccc-84609504ffc7",
  "baseModel": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/models/base/1aae1070-7972-47e9-a977-87e3b05c457d"
  },
  "datasets": [
    {
      "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/datasets/69e46263-ab10-4ab4-abbe-62e370104d95"
    }
  ],
  "links": {
    "manifest": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/models/86c4ebd7-d70d-4f67-9ccc-84609504ffc7/manifest",
    "copyTo": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/models/86c4ebd7-d70d-4f67-9ccc-84609504ffc7:copyto"
  },
  "project": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.1/projects/5d25e60a-7f4a-4816-afd9-783bb8daccfc"
  },
  "properties": {
    "deprecationDates": {
      "adaptationDateTime": "2023-01-15T00:00:00Z",
      "transcriptionDateTime": "2024-07-15T00:00:00Z"
    }
  },
  "lastActionDateTime": "2022-05-21T13:21:01Z",
  "status": "Succeeded",
  "createdDateTime": "2022-05-22T16:37:01Z",
  "locale": "en-US",
  "displayName": "My Model",
  "description": "My Model Description"
}

Cycle de vie des modèles vocaux personnalisés

Chronologie d’expiration

Actions à effectuer lorsqu’un modèle expire

Obtenir les dates d’expiration du modèle de base

Obtenir les dates d’expiration de modèles personnalisés

Étapes suivantes

Ressources supplémentaires