自訂語音模型生命週期

發行項
04/13/2024

將自訂語音模型部署至自定義端點之後，您可以使用一段時間的自定義語音模型。但是，當新的基底模型可供使用時，較舊的模型就會過期。您必須定期從最新的基底模型重新建立和定型自定義模型，以利用改良的精確度和品質。

以下是與模型生命周期相關的一些重要詞彙：

定型：使用文字數據和/或音訊數據，將基底模型自定義至您的網域/案例。在某些內容中，例如 REST API 屬性，訓練也稱為適應。
轉譯：使用模型並執行語音辨識（將音訊譯碼為文字）。
端點：基底模型或僅您可以存取的自定義模型的特定部署。

注意

語音資源所使用的 F0 端點會在七天后刪除。

到期時間表

以下是模型調整和轉譯到期的時程表：

Microsoft 建立基底模型時，訓練會在季度之後一年提供。
當 Microsoft 建立基底模型時，使用基底模型的轉譯可在季度之後兩年內使用。
當您建立自定義模型時，自定義模型的轉譯會在季度之後兩年內使用。

在此背景下，季度於 1 月 15 日、4 月 15 日、7 月 15 日和 10 月 15 日結束。

模型到期時的動作

當自定義模型或基底模型過期時，就無法再用於轉譯。您可以變更自定義語音端點所使用的模型，而不需要停機。

轉譯路由	過期的模型結果	建議
自訂端點	語音辨識要求會回復為相同地區設定的最新基底模型。您取得結果，但辨識可能無法準確地轉譯您的網域數據。	如部署自定義語音模型指南中所述，更新端點的模型。
批次轉譯	過期模型的批次轉譯要求失敗，並出現 4xx 錯誤。	在每個 Transcriptions_Create REST API 要求本文中，將 `model` 屬性設定為基底模型或未過期的自定義模型。否則，請勿包含 `model` 屬性，以一律使用最新的基底模型。

取得基本模型到期日

當您建立自定義模型時，會顯示您可以使用基底模型進行定型的最後一個日期。如需詳細資訊，請參閱定型自定義語音模型。

請依照下列指示取得基底模型的轉譯到期日：

登入 Speech Studio。
選取 [自定義語音> 您的項目名稱 >部署模型]。
模型的到期日會顯示在 [到期] 數據行中。此日期是您可以使用模型進行轉譯的最後一個日期。

若要取得基底模型的定型和轉譯到期日，請使用 spx csr model status 命令。根據下列指示來建構要求參數：

將 url 參數設定為您想要取得之基底模型的 URI。您可以執行 spx csr list --base 命令來取得所有地區設定的可用基底模型。

以下是範例語音 CLI 命令，可取得基底模型的定型和轉譯到期日：

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

在回應中，記下屬性中的 adaptationDateTime 日期。這個屬性是最後一個日期，您可以使用基底模型進行定型。也請記下屬性中的 transcriptionDateTime 日期。此日期是您可以使用基底模型進行轉譯的最後一個日期。

您應該會收到下列格式的回應本文：

{
  "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"
}

如需在模型使用語音 CLI 的說明，請執行下列命令：

spx help csr model

若要取得基底模型的定型和謄寫到期日，請使用語音轉換文字 REST API 的 Models_GetBaseModel 作業。您可以提出 Models_ListBaseModels 要求，以取得所有地區設定的可用基底模型。

使用模型 URI 提出 HTTP GET 要求，如下列範例所示。將取代為您的模型標識碼、將取代BaseModelIdYourSubscriptionKey為您的語音資源密鑰，並將取代YourServiceRegion為您的語音資源區域。

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

在回應中，記下屬性中的 adaptationDateTime 日期。此日期是您可以使用基底模型進行定型的最後一個日期。也請記下屬性中的 transcriptionDateTime 日期。此日期是您可以使用基底模型進行轉譯的最後一個日期。

您應該會收到下列格式的回應本文：

{
  "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"
}

取得自定義模型到期日

請依照下列指示取得自定義模型的轉譯到期日：

登入 Speech Studio。
選取 [自定義語音> 您的項目名稱 >定型自定義模型]。
自定義模型的到期日會顯示在 [到期] 資料行中。此日期是您可以使用自定義模型進行轉譯的最後一個日期。基底模型不會顯示在 [定型自定義模型 ] 頁面上。

您也可以遵循下列指示來取得自定義模型的轉譯到期日：

登入 Speech Studio。
選取 [自定義語音> 您的項目名稱 >部署模型]。
模型的到期日會顯示在 [到期] 數據行中。此日期是您可以使用模型進行轉譯的最後一個日期。

若要取得自定義模型的轉譯到期日，請使用 spx csr model status 命令。根據下列指示來建構要求參數：

將 url 參數設定為您想要取得之模型的 URI。將取代為您的模型標識碼，並將取代YourModelIdYourServiceRegion為您的語音資源區域。

以下是範例語音 CLI 命令，可取得自定義模型的轉譯到期日：

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

在回應中，記下屬性中的 transcriptionDateTime 日期。此日期是您可以使用自定義模型進行轉譯的最後一個日期。屬性 adaptationDateTime 不適用，因為自定義模型不會用來定型其他自定義模型。

您應該會收到下列格式的回應本文：

{
  "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"
}

如需在模型使用語音 CLI 的說明，請執行下列命令：

spx help csr model

若要取得自訂模型的謄寫到期日，請使用語音轉換文字 REST API 的 Models_GetCustomModel 作業。

使用模型 URI 提出 HTTP GET 要求，如下列範例所示。將取代為您的模型標識碼、將取代YourModelIdYourSubscriptionKey為您的語音資源密鑰，並將取代YourServiceRegion為您的語音資源區域。

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

您應該會收到下列格式的回應本文：

{
  "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"
}

自訂語音模型生命週期

到期時間表

模型到期時的動作

取得基本模型到期日

取得自定義模型到期日

下一步

其他資源