사용자 지정 음성 모델 수명 주기

아티클
02/23/2024

사용자 지정 엔드포인트에 배포한 후 한동안 사용자 지정 음성 모델을 사용할 수 있습니다. 그렇지만 새 기본 모델을 사용할 수 있게 되면 이전 모델은 만료됩니다. 개선된 정확도와 품질을 활용하려면 최신 베이스 모델에서 사용자 지정 모델을 주기적으로 다시 만들고 학습해야 합니다.

모델 수명 주기와 관련된 일부 주요 용어는 다음과 같습니다.

학습: 베이스 모델을 사용하고 텍스트 데이터 및/또는 오디오 데이터를 사용하여 도메인/시나리오로 사용자 지정합니다. REST API 속성과 같은 일부 컨텍스트에서는 학습을 적응이라고도 합니다.
대화 기록: 모델을 사용하고 음성 인식을 수행합니다(오디오를 텍스트로 디코딩).
엔드포인트: 사용자만 액세스할 수 있는 베이스 모델 또는 사용자 지정 모델의 특정 배포입니다.

참고 항목

F0 음성 리소스에서 사용하는 엔드포인트는 7일 후에 삭제됩니다.

만료 타임라인

모델 적응 및 대화 기록 만료 일정은 다음과 같습니다.

학습은 Microsoft가 베이스 모델을 만든 분기 이후 1년 동안 제공됩니다.
베이스 모델을 사용한 대화 기록은 Microsoft가 베이스 모델을 만든 분기 이후 2년 동안 사용할 수 있습니다.
사용자 지정 모델을 사용한 대화 기록은 사용자 지정 모델을 만든 분기 이후 2년 동안 사용할 수 있습니다.

이러한 컨텍스트에서 분기는 1월 15일, 4월 15일, 7월 15일, 10월 15일에 종료됩니다.

모델이 만료되는 경우 수행할 작업

사용자 지정 모델 또는 베이스 모델이 만료되면 더 이상 대화 기록에 사용할 수 없습니다. 가동 중지 시간 없이 Custom Speech 엔드포인트에서 사용하는 모델을 변경할 수 있습니다.

대화 기록 경로	만료된 모델 결과	권장
사용자 지정 엔드포인트	음성 인식 요청은 동일한 로캘에 대한 최신 베이스 모델로 대체됩니다. 결과가 제공되지만 인식이 도메인 데이터를 정확하게 기록하지 못할 수 있습니다.	사용자 지정 음성 모델 배포 가이드에 설명된 대로 엔드포인트의 모델을 업데이트합니다.
전사 일괄 처리	만료된 모델에 대한 일괄 처리 대화 기록 요청이 4xx 오류로 인해 실패합니다.	각 Transcriptions_Create REST API 요청 본문에서 `model` 속성을 만료되지 않은 베이스 모델 또는 사용자 지정 모델로 설정합니다. 그렇지 않으면 항상 최신 기본 모델을 사용하는 `model` 속성을 포함하지 않습니다.

기본 모델 만료 날짜 가져오기

학습에 기본 모델을 사용할 수 있는 마지막 날짜는 사용자 지정 모델을 만들 때 표시되었습니다. 자세한 내용은 사용자 지정 음성 모델 학습을 참조하세요.

다음 지침에 따라 기본 모델의 대화 기록 만료 날짜를 가져옵니다.

Speech Studio에 로그인합니다.
사용자 지정 음성> 내 프로젝트 이름 >모델 배포를 선택합니다.
모델의 만료 날짜는 만료 열에 표시됩니다. 이 날짜는 대화 기록에 모델을 사용할 수 있는 마지막 날짜입니다.

기본 모델에 대한 학습 및 대화 기록 만료 날짜를 얻으려면 spx csr model status 명령을 사용합니다. 다음 지침에 따라 요청 매개 변수를 생성합니다.

url 매개 변수를 가져올 기본 모델의 URI로 설정합니다. spx csr list --base 명령을 실행하여 모든 로캘에 사용 가능한 기본 모델을 가져올 수 있습니다.

다음은 기본 모델에 대한 학습 및 대화 기록 만료 날짜를 가져오는 Speech 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"
}

모델에 대한 Speech CLI 도움말을 보려면 다음 명령을 실행합니다.

spx help csr model

기본 모델에 대한 학습 및 대화 내용 기록 만료 날짜를 가져오려면 음성 텍스트 변환 REST API의 Models_GetBaseModel 작업을 사용합니다. Models_ListBaseModels 요청을 수행하여 모든 로캘에 사용 가능한 기본 모델을 가져올 수 있습니다.

다음 예제와 같이 모델 URI를 사용하여 HTTP GET 요청을 만듭니다. BaseModelId를 모델 ID로 바꾸고, 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를 모델 ID로 바꾸고, YourServiceRegion을 음성 리소스 지역으로 바꿉니다.

다음은 사용자 지정 모델에 대한 대화 기록 만료 날짜를 가져오는 Speech 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"
}

모델에 대한 Speech CLI 도움말을 보려면 다음 명령을 실행합니다.

spx help csr model

사용자 지정 모델의 대화 기록 만료 날짜를 확인하려면 음성 텍스트 변환 REST API의 Models_GetCustomModel 작업을 사용합니다.

다음 예제와 같이 모델 URI를 사용하여 HTTP GET 요청을 만듭니다. YourModelId를 모델 ID로 바꾸고, YourSubscriptionKey를 음성 리소스 키로 바꾸고, 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"
}

사용자 지정 음성 모델 수명 주기

만료 타임라인

모델이 만료되는 경우 수행할 작업

기본 모델 만료 날짜 가져오기

사용자 지정 모델 만료 날짜 가져오기

다음 단계

추가 리소스