自訂語音模型生命週期
將自訂語音模型部署至自訂端點後,您可以使用該模型一段時間。 但每當有新的基底模型可供使用時,舊版模型就會過期。 您必須從最新的基底模型定期重新建立自訂模型並進行定型,以善用改善的精確度和品質。
以下是與模型生命週期相關的一些重要詞彙:
- 定型:取用基底模型,並使用文字資料和/或音訊資料根據您的領域/案例加以自訂。 在某些內容中 (例如 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 要求,如下列範例所示。 以您的模型識別碼取代 BaseModelId
、以您的語音資源金鑰取代 YourSubscriptionKey
,並以您的語音資源區域取代 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。 以您的模型識別碼取代YourModelId
,並以您的語音資源區域取代YourServiceRegion
。
以下是範例語音 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 要求,如下列範例所示。 以您的模型識別碼取代 YourModelId
、以您的語音資源金鑰取代 YourSubscriptionKey
,並以您的語音資源區域取代 YourServiceRegion
。
curl -v -X GET "https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/v3.1/models/YourModelId" -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey"
在回應中,記下 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"
}