Migrieren von Code von v3.2 zu Version 2024-11-15
Die Spracherkennungs-REST-API wird für schnelle Transkription, Batchtranskription und Custom Speech verwendet. In diesem Artikel werden Änderungen von Version 3.2 zu Version 2024-11-15 beschrieben.
Wichtig
Version 2024-11-15 der Spracherkennungs-REST-API ist die aktuelle Version, die allgemein verfügbar ist.
- Version
2024-05-15-previewder Spracherkennungs-REST-API wird zu einem Datum eingestellt, das noch bekannt gegeben wird. - Spracherkennungs-REST-API
v3.0,v3.1,v3.2,3.2-preview.1und3.2-preview.2werden am 1. April 2026 eingestellt.
Weitere Informationen zum Upgraden finden Sie in den Migrationsleitfäden v3.0 zu v3.1, v3.1 zu v3.2 und v3.2 to 2024-11-15 der Spracherkennung-REST-API.
Basispfad
Die Custom Speech-API wurde von einem pfadbasierten Versionsverwaltungsschema auf ein auf Abfrageparametern basierendes Schema in Übereinstimmung mit allgemeinen Azure-API-Versionsverwaltungsschemas umgestellt. Dies erforderte Änderungen am verwendeten Basispfad. Aktualisieren Sie den Pfad von /speechtotext/v3.2 auf /speechtotext, und fügen Sie die API-Version mit ?api-version=2024-11-15 an alle Anforderungen an.
Datasets
Die Eigenschaft email und der verbundene Prozess für die E-Mail-Benachrichtigung wird aus der API entfernt.
Die duration-Eigenschaft in Datasetantworten wird von duration in durationMilliseconds umbenannt und ist jetzt eine einfache Zahl anstelle einer ISO8601-formatierten Zeichenfolge (P1D2H3M4S…), um die Verarbeitung weiter zu vereinfachen.
Der Abfrageparameter sasValidityInSeconds wird zum Abrufen von Dateien in sasLifetimeMinutes umbenannt. Die Verwendung ist nur für ein Konto zulässig, für das BYOS deaktiviert ist. Für Konten mit BYOS-Aktivierung werden keine SAS-URLs zurückgegeben.
Die Eigenschaft project wird in Erstellungsanforderungen entfernt.
Modelle
Die Eigenschaft text in einer Modellerstellungsanforderung wurde entfernt. Die Alternative besteht darin, ein Dataset mit dem Textinhalt und zuerst ein Dataset zu erstellen, das später zur Modellerstellung verwendet wird.
Die Eigenschaft email und der verbundene Prozess für die E-Mail-Benachrichtigung wird aus der API entfernt.
Der Abfrageparameter sasValidityInSeconds wird zum Abrufen von Dateien in sasLifetimeMinutes umbenannt. Die Verwendung ist nur für ein Konto zulässig, für das BYOS (Bring Your Own Storage) deaktiviert ist. Für Konten mit BYOS-Aktivierung werden keine SAS-URLs zurückgegeben.
Für den Vorgang GET models/id/manifest ist nun immer eine SAS-Lebensdauer ungleich 0 erforderlich. Die entsprechende sasValidityInSeconds-Eigenschaft wird in sasLifetimeMinutes umbenannt.
Die Eigenschaft project wird in Erstellungsanforderungen entfernt.
Auswertungen
Der Abfrageparameter sasValidityInSeconds wird zum Abrufen von Dateien in sasLifetimeMinutes umbenannt. Die Verwendung ist nur für ein Konto zulässig, für das BYOS deaktiviert ist. Für Konten mit BYOS-Aktivierung werden keine SAS-URLs zurückgegeben.
Die Eigenschaft project wird in Erstellungsanforderungen entfernt.
Die Eigenschaft email und der verbundene Prozess für die E-Mail-Benachrichtigung wird aus der API entfernt.
Endpunkte
Die API zum Abrufen und Löschen von Protokolldateien von Endpunktprotokollen wird entfernt. Custom Speech unterstützt jetzt BYOS (Bring Your Own Storage). Nur Konten mit BYOS-Aktivierung können die Protokollierung auf Modellendpunkten aktivieren. Dies bietet vollständige Verwaltbarkeit von Protokolldateien im Kundenspeicher anstelle einer Proxy-API.
Die Unterstützung für timeToLive bei Endpunkterstellungen wurde entfernt.
Die Eigenschaft text in einer Endpunkterstellungsanforderung wurde entfernt. Die Alternative besteht darin, ein Dataset mit dem Textinhalt und zuerst ein Dataset zu erstellen, das später zur Modellerstellung verwendet wird. Dieses Modell kann dann zum Erstellen eines Endpunkts verwendet werden.
Endpunktlinks geben jetzt nur Endpunkte der WebSocket-Verbindung zurück, die für das SDK verwendet wird.
Die Eigenschaft project wird in Erstellungsanforderungen entfernt.
Die Eigenschaft email und der verbundene Prozess für die E-Mail-Benachrichtigung wird aus der API entfernt.
Transkriptionen
Die Eigenschaft diarizationEnabled auf oberster Ebene einer Transkription wurde entfernt. Die Diarisierungskonfiguration wurde vereinfacht und lautet jetzt "diarization": {"maxSpeakers": 2,"enabled": true}. Die maxSpeakers-Eigenschaft ist optional und standardmäßig auf „2“ festgelegt. Die enabled-Eigenschaft ist für die Diarisierung erforderlich.
Transkriptionserstellung: timeToLive wurde in timeToLiveHours umbenannt, einschließlich einer Formatänderung von einer ISO8601-formatierten Zeichenfolge in eine einfache Ganzzahl (Anzahl von Stunden).
Die duration-Eigenschaft in Transkriptionsantworten wird von duration in durationMilliseconds umbenannt und ist jetzt eine einfache Zahl anstelle einer ISO8601-formatierten Zeichenfolge (P1D2H3M4S…), um die Verarbeitung weiter zu vereinfachen. Den Transkriptionsergebnisdateien wurde diese Eigenschaft aus Gründen der Konsistenz mit der API hinzugefügt.
Der Abfrageparameter sasValidityInSeconds wird zum Abrufen von Dateien in sasLifetimeMinutes umbenannt. Die Verwendung ist nur für ein Konto zulässig, für das BYOS deaktiviert ist. Für Konten mit BYOS-Aktivierung werden keine SAS-URLs zurückgegeben.
Die Eigenschaft project wird in Erstellungsanforderungen entfernt.
Die Eigenschaft email und der verbundene Prozess für die E-Mail-Benachrichtigung wird aus der API entfernt.
Projekte
Die Projekt-API wird entfernt.