Migrar código da v3.2 para a versão 2024-11-15
A API REST de Conversão de fala em texto é 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 2024-11-15.
Importante
A versão 2024-11-15 mais recente da API REST de Conversão de fala em texto está disponível.
- A API REST de Conversão de fala em texto versão
2024-05-15-previewanterior será desativada em uma data a ser anunciada. - A API REST de Conversão de fala em texto
v3.0,v3.1,v3.2,3.2-preview.1e3.2-preview.2serão desativadas em 1º de abril de 2026.
Para mais informações sobre a atualização, consulte os guias de migração da API REST de Conversão de fala em texto 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 baseado em parâmetro de consulta em alinhamento com esquemas gerais de controle de versão da API do Azure. Isso exige alterações no caminho base usado. Atualize o caminho de /speechtotext/v3.2 para /speechtotext e acrescente a versão da API com ?api-version=2024-11-15 a todas as solicitações.
Conjunto de dados
A propriedade email e o processo de notificação de email conectado são removidos da API.
A propriedade duration em respostas de conjunto de dados é renomeada de duration para durationMilliseconds e agora é um número simples em vez de uma cadeia de caracteres formatada ISO8601 (P1D2H3M4S...) para simplesmente processar.
O parâmetro de consulta sasValidityInSeconds é renomeado como sasLifetimeMinutes para obter arquivos. O uso só é permitido para uma conta com BYOS desabilitado. Para contas com BYOS habilitadas, as URLs SAS não são retornadas.
A propriedade project é removida em solicitações de criação.
Modelos
Removida a propriedade text em uma solicitação de criação de modelo. A alternativa é criar um conjunto de dados com o conteúdo de texto e criar um conjunto de dados primeiro, que depois será usado para a criação do modelo.
A propriedade email e o processo de notificação de email conectado são removidos da API.
O parâmetro de consulta sasValidityInSeconds é renomeado como sasLifetimeMinutes para obter arquivos. O uso só é permitido para uma conta com BYOS (traga seu próprio armazenamento) desabilitado. Para contas com BYOS habilitadas, as URLs SAS não são retornadas.
Agora, a operação GET models/id/manifest sempre exige um tempo de vida de SAS diferente de zero. A propriedade sasValidityInSeconds correspondente é renomeada para sasLifetimeMinutes.
A propriedade project é removida em solicitações de criação.
Avaliações
O parâmetro de consulta sasValidityInSeconds é renomeado como sasLifetimeMinutes para obter arquivos. O uso só é permitido para uma conta com BYOS desabilitado. Para contas com BYOS habilitadas, as URLs SAS não são retornadas.
A propriedade project é removida em solicitações de criação
A propriedade email e o processo de notificação de email conectado são removidos da API.
Pontos de extremidade
A API para recuperar e excluir arquivos de log dos logs de ponto de extremidade é removida. A fala personalizada dá suporte ao BYOS (traga seu próprio armazenamento) agora. Somente contas com BYOS habilitado podem permitir o registro em log 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 proxy.
Removido o suporte para timeToLive em criações de ponto de extremidade.
Removida a propriedade text em uma solicitação de criação de 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 será usado para a criação do modelo. Esse modelo pode ser usado para criar um ponto de extremidade.
Agora, os links de ponto de extremidade retornam apenas o ponto de extremidade da conexão WebSocket, usado para o SDK.
A propriedade project é removida em solicitações de criação.
A propriedade email e o processo de notificação de email conectado são removidos da API.
Transcrições
Removida a propriedade diarizationEnabled de nível superior de uma transcrição. A configuração de diarização é simplificada para "diarization": {"maxSpeakers": 2,"enabled": true}. A propriedade maxSpeakers é opcional e tem como padrão 2. A propriedade enabled é necessária para a diarização.
Criação de transcrição: timeToLive renomeada para timeToLiveHours incluindo uma alteração de formato da cadeia de caracteres formatada ISO8601 para um int simples (número de horas).
A propriedade duration em respostas de transcrição é renomeada de duration para durationMilliseconds e agora é um número sem formatação em vez de uma cadeia de caracteres formatada ISO8601 (P1D2H3M4S...) para simplificar ainda mais o processamento. Os arquivos de resultado da transcrição têm essa propriedade adicionada para consistência com a API.
O parâmetro de consulta sasValidityInSeconds é renomeado como sasLifetimeMinutes para obter arquivos. O uso só é permitido para uma conta com BYOS desabilitado. Para contas com BYOS habilitadas, as URLs SAS não são retornadas.
A propriedade project é removida em solicitações de criação.
A propriedade email e o processo de notificação de email conectado são removidos da API.
Projetos
A API de projetos é removida.