Udostępnij za pośrednictwem


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.0REST zamiany mowy na tekst , , 3.2-preview.1v3.1v3.2, i 3.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.

Następne kroki