Ciclo de vida do modelo de fala personalizada

Artigo
01/22/2024

Você pode usar um modelo de fala personalizada por algum tempo depois de implantado em seu ponto de extremidade personalizado. Mas quando novos modelos básicos são disponibilizados, os modelos mais antigos expiram. Você deve recriar e treinar periodicamente seu modelo personalizado com o modelo base mais recente para aproveitar a precisão e a qualidade aprimoradas.

Aqui estão alguns termos-chave relacionados ao ciclo de vida do modelo:

Treinamento: pegar um modelo base e personalizá-lo para seu domínio/cenário usando dados de texto e/ou dados de áudio. Em alguns contextos, como as propriedades da API REST, o treinamento também é chamado de adaptação.
Transcrição: usar um modelo e executar o reconhecimento de fala (decodificar o áudio em texto).
Ponto de extremidade: uma implantação específica de um modelo base ou um modelo personalizado que só você pode acessar.

Observação

Os pontos de extremidade usados pelos recursos de Fala F0 são excluídos após sete dias.

Linha do tempo de término

Estas são as linhas do tempo de validade de adaptação e transcrição de modelo:

O treinamento está disponível por um ano após o trimestre em que a Microsoft criou o modelo base.
A transcrição com um modelo base está disponível por dois anos após o trimestre em que a Microsoft criou o modelo base.
A transcrição com um modelo personalizado está disponível por dois anos após o trimestre em que você o criou.

Nesse contexto, os trimestres terminam em 15 de janeiro, 15 de abril, 15 de julho e 15 de outubro.

O que fazer quando um modelo expira

Quando um modelo ou modelo base personalizado expira, ele não está mais disponível para transcrição. Você pode alterar o modelo usado pelo ponto de extremidade de fala personalizado sem tempo de inatividade:

Rota de transcrição	Resultado do modelo expirado	Recomendação
Ponto de extremidade personalizado	As solicitações de reconhecimento de fala retornam ao modelo base mais recente para a mesma localidade. Você obtém resultados, mas o reconhecimento pode não transcrever com precisão seus dados de domínio.	Atualize o modelo do ponto de extremidade conforme descrito no guia Implantar um modelo de fala personalizada.
Transcrição de lote	As solicitações de transcrição em lote para modelos expirados falham com um erro 4xx.	Em cada corpo de solicitação da API REST Transcriptions_Create, defina a `model`propriedade para um modelo base ou modelo personalizado que não expirou. Caso contrário, não inclua a `model` propriedade de usar sempre o modelo base mais recente.

Obter datas de expiração do modelo base

A última data em que você poderia usar o modelo base para treinamento foi mostrada quando você criou o modelo personalizado. Para obter mais informações, consulte Treinar um modelo de fala personalizada.

Siga estas instruções para obter a data de validade da transcrição para um modelo básico:

Entre no Speech Studio.
Selecione Fala personalizada> Nome do seu projeto >Implantar modelos.
A data de validade do modelo é mostrada na coluna Expiração . Esta data é a última em que você pode usar o modelo para transcrição.

Para obter as datas de validade de treinamento e transcrição de um modelo base, use o spx csr model status comando. Crie os parâmetros de solicitação de acordo com as seguintes instruções:

Defina o parâmetro url como o URI do modelo base que você deseja obter. Você pode executar o spx csr list --base comando para obter modelos de base disponíveis para todas as localidades.

Aqui está um exemplo de comando Speech CLI para obter as datas de expiração de treinamento e transcrição para um modelo 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

Na resposta, anote a data na adaptationDateTime propriedade. Esta propriedade é a última data em que você pode usar o modelo base para treinamento. Anote também a data na transcriptionDateTime propriedade. Esta data é a última em que você pode usar o modelo base para transcrição.

Você deve receber um corpo de resposta no seguinte formato:

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

Para obter a ajuda da CLI de Fala com modelos, execute o seguinte comando:

spx help csr model

Para obter as datas de validade de treinamento e transcrição para um modelo base, use a operação Models_GetBaseModel da API REST de reconhecimento de fala. Você pode fazer uma solicitação Models_ListBaseModels para obter modelos base disponíveis de todas as localidades.

Faça uma solicitação HTTP GET usando o URI do modelo conforme mostrado no exemplo a seguir. Substitua BaseModelIdpor sua ID de modelo, substitua YourSubscriptionKey por sua chave de recurso de fala e substitua YourServiceRegionpor sua região de recurso de fala.

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

Na resposta, anote a data na adaptationDateTime propriedade. Esta data é a última em que você pode usar o modelo base para treinamento. Anote também a data na transcriptionDateTime propriedade. Esta data é a última em que você pode usar o modelo base para transcrição.

Você deve receber um corpo de resposta no seguinte formato:

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

Obter datas de validade do modelo personalizado

Siga estas instruções para obter a data de validade da transcrição para um modelo personalizado:

Entre no Speech Studio.
Selecione Fala personalizada> Nome do projeto >Treinar modelos personalizados.
A data de validade do modelo personalizado é mostrada na coluna Expiração . Esta data é a última em que você pode usar o modelo para transcrição. Os modelos base não são mostrados na página Treinar modelos personalizados.

Você também pode seguir estas instruções para obter a data de expiração da transcrição para um modelo personalizado:

Entre no Speech Studio.
Selecione Fala personalizada> Nome do seu projeto >Implantar modelos.
A data de validade do modelo é mostrada na coluna Expiração . Esta data é a última em que você pode usar o modelo para transcrição.

Para obter a data de validade da transcrição para seu modelo personalizado, use o spx csr model status comando. Crie os parâmetros de solicitação de acordo com as seguintes instruções:

Defina o parâmetro url como o URI do modelo que você deseja obter. Substitua YourModelId por seu ID de modelo e substitua YourServiceRegionpor sua região de recurso de fala.

Aqui está um exemplo de comando da CLI de Fala para obter a data de validade da transcrição para seu modelo personalizado:

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

Na resposta, anote a data na transcriptionDateTime propriedade. Esta data é a última em que você pode usar o modelo personalizado para transcrição. A propriedade adaptationDateTime não é aplicável, pois os modelos personalizados não são usados para treinar outros modelos personalizados.

Você deve receber um corpo de resposta no seguinte formato:

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

Para obter a ajuda da CLI de Fala com modelos, execute o seguinte comando:

spx help csr model

Para obter a data de validade da transcrição para seu modelo personalizado, use a operação Models_GetCustomModel da API REST de reconhecimento de fala.

Faça uma solicitação HTTP GET usando o URI do modelo conforme mostrado no exemplo a seguir. Substitua YourModelIdpor sua ID de modelo, substitua YourSubscriptionKey por sua chave de recurso de fala e substitua YourServiceRegionpor sua região de recurso de fala.

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

Você deve receber um corpo de resposta no seguinte formato:

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

Ciclo de vida do modelo de fala personalizada

Linha do tempo de término

O que fazer quando um modelo expira

Obter datas de expiração do modelo base

Obter datas de validade do modelo personalizado

Próximas etapas

Recursos adicionais