Migrar código da v3.2 para a versão 2024-11-15
A API REST Speech to text é usada para transcrição rápida, transcrição em lote e fala personalizada. Este artigo descreve as alterações da versão 3.2 para a versão 2024-11-15.
Importante
A versão 2024-11-15 da API REST de fala para texto é a versão mais recente disponível ao público.
- A versão
2024-05-15-previewda API REST de fala para texto será desativada em uma data a ser anunciada. - Speech to text REST API
v3.0,v3.1,v3.2,3.2-preview.1, e3.2-preview.2será desativada em 1º de abril de 2026.
Para obter mais informações sobre atualização, consulte os guias de migração Speech to text REST API v3.0 para v3.1, v3.1 para v3.2 e v3.2 para 2024-11-15 .
Caminho base
A API de fala personalizada mudou de um esquema de controle de versão baseado em caminho para um esquema baseado em parâmetros de consulta em alinhamento com esquemas gerais de controle de versão da API do Azure. Isso exigiu alterações no caminho base usado. Atualize o caminho de e anexe a /speechtotext versão da /speechtotext/v3.2 API a ?api-version=2024-11-15 todas as solicitações.
Conjuntos de Dados
A email propriedade e o processo de notificação por e-mail conectado são removidos da API.
A duration propriedade nas respostas do conjunto de dados é renomeada de duration para durationMilliseconds e agora são um número simples em vez de uma cadeia de caracteres formatada ISO8601 (P1D2H3M4S...) para continuar o processamento simples.
O parâmetro sasValidityInSeconds query é renomeado para sasLifetimeMinutes para obter arquivos. O uso só é permitido para uma conta com o BYOS desativado. Para contas habilitadas para BYOS, as URLs SAS não são retornadas.
A project propriedade é removida em solicitações de criação.
Modelos
Removida a propriedade em uma solicitação de criação de text modelo. A alternativa é criar um conjunto de dados com o conteúdo de texto e criar um conjunto de dados primeiro, que depois é usado para a criação do modelo.
A email propriedade e o processo de notificação por e-mail conectado são removidos da API.
O parâmetro sasValidityInSeconds query é renomeado para sasLifetimeMinutes para obter arquivos. O uso só é permitido para uma conta com BYOS (traga seu próprio armazenamento) desativado. Para contas habilitadas para BYOS, as URLs SAS não são retornadas.
A GET models/id/manifest operação agora sempre requer um tempo de vida SAS diferente de zero. A propriedade correspondente sasValidityInSeconds é renomeada para sasLifetimeMinutes.
A project propriedade é removida em solicitações de criação.
Avaliações
O parâmetro sasValidityInSeconds query é renomeado para sasLifetimeMinutes para obter arquivos. O uso só é permitido para uma conta com o BYOS desativado. Para contas habilitadas para BYOS, as URLs SAS não são retornadas.
A project propriedade é removida em solicitações de criação
A email propriedade e o processo de notificação por e-mail conectado são removidos da API.
Pontos finais
A API para recuperar e excluir arquivos de log de logs de ponto de extremidade é removida. A fala personalizada agora suporta BYOS (traga seu próprio armazenamento). Somente contas com BYOS habilitado podem habilitar o registro em pontos de extremidade de modelo. Isso oferece total capacidade de gerenciamento de arquivos de log no armazenamento do cliente em vez de uma API de proxy.
Removido o suporte para timeToLive criações de pontos finais.
Removida a propriedade em uma solicitação de criação de text ponto de extremidade. A alternativa é criar um conjunto de dados com o conteúdo de texto e criar um conjunto de dados primeiro, que depois é usado para a criação do modelo. Esse modelo pode ser usado para criar um ponto de extremidade.
Os links de ponto de extremidade agora retornam apenas o ponto de extremidade da conexão websocket, usado para SDK.
A project propriedade é removida em solicitações de criação.
A email propriedade e o processo de notificação por e-mail conectado são removidos da API.
Transcrições
Removida a propriedade de nível diarizationEnabled superior de uma transcrição. A configuração de diarização é simplificada para "diarization": {"maxSpeakers": 2,"enabled": true}. A maxSpeakers propriedade é opcional e o padrão é 2. A enabled propriedade é necessária para a diarização.
Criação de transcrição: timeToLive renomeada para timeToLiveHours incluir uma mudança de formato de ISO8601 string formatada para um int simples (número de horas).
A duration propriedade nas respostas de transcrição é renomeada de duration para durationMilliseconds e agora são um número simples em vez de uma cadeia de caracteres formatada ISO8601 (P1D2H3M4S...) para simplificar ainda mais o processamento. Os arquivos de resultado de transcrição têm essa propriedade adicionada para consistência com a API.
O parâmetro sasValidityInSeconds query é renomeado para sasLifetimeMinutes para obter arquivos. O uso só é permitido para uma conta com o BYOS desativado. Para contas habilitadas para BYOS, as URLs SAS não são retornadas.
A project propriedade é removida em solicitações de criação.
A email propriedade e o processo de notificação por e-mail conectado são removidos da API.
Projetos
A API de projetos é removida.