Migrowanie kodu z wersji 3.2 do wersji 2024-11-15
Interfejs API REST zamiany mowy na tekst jest używany do szybkiej transkrypcji, transkrypcji wsadowej i mowy niestandardowej. W tym artykule opisano zmiany z wersji 3.2 do wersji 2024-11-15.
Ważne
Wersja 2024-11-15
interfejsu API REST zamiany mowy na tekst jest najnowszą wersją, która jest ogólnie dostępna.
- Wersja
2024-05-15-preview
interfejsu API REST zamiany mowy na tekst zostanie wycofana w dniu ogłoszenia. - Interfejs API
v3.0
REST zamiany mowy na tekst , ,3.2-preview.1
v3.1
v3.2
, i3.2-preview.2
zostanie wycofany 1 kwietnia 2026 r.
Aby uzyskać więcej informacji na temat uaktualniania, zobacz Przewodniki migracji interfejsu API REST zamiany mowy na tekst w wersji 3.0 do 3.1, 3.1 do 3.2 i 3.2 do 2024-11-15.
Ścieżka podstawowa
Niestandardowy interfejs API rozpoznawania mowy został przełączony ze schematu przechowywania wersji opartego na ścieżkach do schematu opartego na parametrach zapytania zgodnie z ogólnymi schematami przechowywania wersji interfejsu API platformy Azure. To wymaga zmian w używanej ścieżce podstawowej. Zaktualizuj ścieżkę z /speechtotext/v3.2
do /speechtotext
i dołącz wersję ?api-version=2024-11-15
interfejsu API do wszystkich żądań.
Zestawy danych
Właściwość email
i połączony proces powiadomień e-mail są usuwane z interfejsu API.
Nazwa duration
właściwości w odpowiedziach zestawu danych jest zmieniana z duration
na durationMilliseconds
i jest teraz zwykłą liczbą zamiast ISO8601 sformatowanego ciągu (P1D2H3M4S...), aby jeszcze bardziej po prostu przetwarzać.
Nazwa parametru sasValidityInSeconds
zapytania jest zmieniana na sasLifetimeMinutes
w celu pobierania plików. Użycie jest dozwolone tylko dla konta z wyłączonym rozwiązaniem BYOS. W przypadku kont z obsługą usługi BYOS adresy URL sygnatur dostępu współdzielonego nie są zwracane.
Właściwość project
jest usuwana w żądaniach tworzenia.
Modele
Usunięto text
właściwość w żądaniu utworzenia modelu. Alternatywą jest utworzenie zestawu danych z zawartością tekstową i najpierw utworzenie zestawu danych, który następnie będzie później używany do tworzenia modelu.
Właściwość email
i połączony proces powiadomień e-mail są usuwane z interfejsu API.
Nazwa parametru sasValidityInSeconds
zapytania jest zmieniana na sasLifetimeMinutes
w celu pobierania plików. Użycie jest dozwolone tylko dla konta z wyłączonym użyciem usługi BYOS (bring your own storage). W przypadku kont z obsługą usługi BYOS adresy URL sygnatur dostępu współdzielonego nie są zwracane.
Operacja GET models/id/manifest
zawsze wymaga okresu istnienia sygnatury dostępu współdzielonego bezzerowego. Nazwa odpowiedniej sasValidityInSeconds
właściwości została zmieniona na sasLifetimeMinutes
.
Właściwość project
jest usuwana w żądaniach tworzenia.
Oceny
Nazwa parametru sasValidityInSeconds
zapytania jest zmieniana na sasLifetimeMinutes
w celu pobierania plików. Użycie jest dozwolone tylko dla konta z wyłączonym rozwiązaniem BYOS. W przypadku kont z obsługą usługi BYOS adresy URL sygnatur dostępu współdzielonego nie są zwracane.
Właściwość project
jest usuwana w żądaniach tworzenia
Właściwość email
i połączony proces powiadomień e-mail są usuwane z interfejsu API.
Punkty końcowe
Interfejs API do pobierania i usuwania plików dziennika dzienników dzienników punktów końcowych jest usuwany. Usługa Custom Speech obsługuje teraz usługę BYOS (bring your own storage). Tylko konta z włączoną funkcją BYOS mogą włączać rejestrowanie w punktach końcowych modelu. Zapewnia to pełną możliwość zarządzania plikami dziennika w magazynie klienta zamiast interfejsu API serwera proxy.
Usunięto obsługę timeToLive
tworzenia punktów końcowych.
Usunięto text
właściwość w żądaniu tworzenia punktu końcowego. Alternatywą jest utworzenie zestawu danych z zawartością tekstową i najpierw utworzenie zestawu danych, który następnie będzie później używany do tworzenia modelu. Za pomocą tego modelu można utworzyć punkt końcowy.
Linki punktów końcowych zwracają teraz tylko punkt końcowy połączenia protokołu websocket używanego dla zestawu SDK.
Właściwość project
jest usuwana w żądaniach tworzenia.
Właściwość email
i połączony proces powiadomień e-mail są usuwane z interfejsu API.
Transkrypcje
Usunięto właściwość najwyższego poziomu diarizationEnabled
transkrypcji. Konfiguracja diaryzacji jest uproszczona do "diarization": {"maxSpeakers": 2,"enabled": true}
. Właściwość jest opcjonalna maxSpeakers
i domyślnie ustawiona na 2. Właściwość jest wymagana enabled
do diaryzacji.
Tworzenie transkrypcji: timeToLive
zmieniono nazwę na timeToLiveHours
dołączanie zmiany formatu z ISO8601 sformatowanego ciągu na prostą liczbę godzin (liczba godzin).
Nazwa duration
właściwości w odpowiedziach transkrypcji jest zmieniana z duration
na durationMilliseconds
i jest teraz zwykłą liczbą zamiast ISO8601 sformatowanego ciągu (P1D2H3M4S...), aby jeszcze bardziej uprościć przetwarzanie. Pliki wyników transkrypcji mają tę właściwość dodaną do spójności z interfejsem API.
Nazwa parametru sasValidityInSeconds
zapytania jest zmieniana na sasLifetimeMinutes
w celu pobierania plików. Użycie jest dozwolone tylko dla konta z wyłączonym rozwiązaniem BYOS. W przypadku kont z obsługą usługi BYOS adresy URL sygnatur dostępu współdzielonego nie są zwracane.
Właściwość project
jest usuwana w żądaniach tworzenia.
Właściwość email
i połączony proces powiadomień e-mail są usuwane z interfejsu API.
Projekty
Interfejs API projektów jest usuwany.