Ciclo de vida do modelo de fala personalizado

Artigo
01/22/2024

Você pode usar um modelo de fala personalizado por algum tempo depois de implantá-lo em seu ponto de extremidade personalizado. Mas quando novos modelos de base são disponibilizados, os modelos mais antigos expiram. Você deve recriar e treinar periodicamente seu modelo personalizado a partir do 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 o 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: Usando um modelo e realizando o reconhecimento de fala (decodificação de áudio em texto).
Ponto de extremidade: uma implantação específica de um modelo base ou de um modelo personalizado que só você pode acessar.

Nota

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

Prazo de expiração

Aqui estão os cronogramas para adaptação do modelo e expiração da transcrição:

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ê criou o modelo personalizado.

Neste 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 personalizado ou um modelo base 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 os dados do domínio.	Atualize o modelo do ponto de extremidade conforme descrito no guia Implantar um modelo de fala personalizado.
Transcrição em lotes	As solicitações de transcrição em lote para modelos expirados falham com um erro 4xx.	Em cada Transcriptions_Create corpo de solicitação da API REST, defina a `model` propriedade como um modelo base ou modelo personalizado que não expirou. Caso contrário, não inclua a `model` propriedade para usar sempre o modelo base mais recente.

Obter datas de validade do modelo base

A última data em que você pôde 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 personalizado.

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

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

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

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

Aqui está um exemplo de comando da CLI de fala 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 no adaptationDateTime imóvel. Esta propriedade é a última data em que você pode usar o modelo base para treinamento. Tome também nota da data na transcriptionDateTime propriedade. Esta data é a última data em que você pode usar o modelo base para transcrição.

Deverá 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 ajuda da CLI de fala com modelos, execute o seguinte comando:

spx help csr model

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

Faça uma solicitação HTTP GET usando o URI do modelo, conforme mostrado no exemplo a seguir. Substitua BaseModelId pelo ID do modelo, substitua YourSubscriptionKey pela chave de recurso Fala e substitua YourServiceRegion pela região do recurso 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 no adaptationDateTime imóvel. Esta data é a última data em que você pode usar o modelo base para treinamento. Tome também nota da data na transcriptionDateTime propriedade. Esta data é a última data em que você pode usar o modelo base para transcrição.

Deverá 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 de modelo personalizadas

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

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

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

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

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

Defina o url parâmetro para o URI do modelo que você deseja obter. Substitua YourModelId pelo ID do modelo e substitua YourServiceRegion pela região de recursos de Fala.

Aqui está um exemplo de comando da CLI de fala para obter a data de expiração 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 no transcriptionDateTime imóvel. Esta data é a última data em que você pode usar seu modelo personalizado para transcrição. A adaptationDateTime propriedade não é aplicável, uma vez que os modelos personalizados não são usados para treinar outros modelos personalizados.

Deverá 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 ajuda da CLI de fala com modelos, execute o seguinte comando:

spx help csr model

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

Faça uma solicitação HTTP GET usando o URI do modelo, conforme mostrado no exemplo a seguir. Substitua YourModelId pelo ID do modelo, substitua YourSubscriptionKey pela chave de recurso Fala e substitua YourServiceRegion pela região do recurso Fala.

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

Deverá 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 personalizado

Prazo de expiração

O que fazer quando um modelo expira

Obter datas de validade do modelo base

Obter datas de validade de modelo personalizadas

Próximos passos

Recursos adicionais