Code migreren van v3.2 naar versie 2024-11-15
De REST API voor spraak-naar-tekst wordt gebruikt voor snelle transcriptie, batchtranscriptie en aangepaste spraak. In dit artikel worden wijzigingen beschreven van versie 3.2 in versie 2024-11-15.
Belangrijk
Rest API-versie 2024-11-15 voor spraak-naar-tekst is de nieuwste versie die algemeen beschikbaar is.
- De REST API-versie
2024-05-15-previewvoor spraak-naar-tekst wordt buiten gebruik gesteld op een datum die moet worden aangekondigd. - Spraak-naar-tekst-REST API
v3.0,v3.1,v3.2, en3.2-preview.23.2-preview.1wordt buiten gebruik gesteld op 1 april 2026.
Zie de migratiehandleidingen Speech to text rest API v3.0 naar v3.1, v3.1 naar v3.2 en v3.2 naar 2024-11-15 voor meer informatie over het upgraden.
Basispad
Aangepaste spraak-API is overgeschakeld van een op pad gebaseerd versiebeheerschema naar een schema op basis van een queryparameter in overeenstemming met algemene Schema's voor Azure API-versiebeheer. Dit vereist wijzigingen in het gebruikte basispad. Werk het pad bij van /speechtotext/v3.2 naar /speechtotext en voeg API-versie toe aan ?api-version=2024-11-15 alle aanvragen.
Gegevenssets
De email eigenschap en het verbonden e-mailmeldingsproces worden verwijderd uit de API.
De duration eigenschap in antwoorden op gegevenssets wordt gewijzigd van duration in durationMilliseconds en is nu een gewoon getal in plaats van een ISO8601 opgemaakte tekenreeks (P1D2H3M4S...) om de verwerking verder uit te voeren.
De naam van de queryparameter sasValidityInSeconds wordt gewijzigd om bestanden op te sasLifetimeMinutes halen. Gebruik is alleen toegestaan voor een account waarvoor BYOS is uitgeschakeld. Voor ACCOUNTS waarvoor BYOS is ingeschakeld, worden SAS-URL's niet geretourneerd.
De project eigenschap wordt verwijderd in aanmaakaanvragen.
Modellen
De text eigenschap in een aanvraag voor het maken van een model is verwijderd. Het alternatief is om een gegevensset te maken met de tekstinhoud en eerst een gegevensset te maken, die later wordt gebruikt voor het maken van modellen.
De email eigenschap en het verbonden e-mailmeldingsproces worden verwijderd uit de API.
De naam van de queryparameter sasValidityInSeconds wordt gewijzigd om bestanden op te sasLifetimeMinutes halen. Gebruik is alleen toegestaan voor een account met BYOS (Bring Your Own Storage) uitgeschakeld. Voor ACCOUNTS waarvoor BYOS is ingeschakeld, worden SAS-URL's niet geretourneerd.
De GET models/id/manifest bewerking vereist nu altijd een niet-zero SAS-levensduur. De naam van de bijbehorende sasValidityInSeconds eigenschap is gewijzigd in sasLifetimeMinutes.
De project eigenschap wordt verwijderd in aanmaakaanvragen.
Evaluaties
De naam van de queryparameter sasValidityInSeconds wordt gewijzigd om bestanden op te sasLifetimeMinutes halen. Gebruik is alleen toegestaan voor een account waarvoor BYOS is uitgeschakeld. Voor ACCOUNTS waarvoor BYOS is ingeschakeld, worden SAS-URL's niet geretourneerd.
De project eigenschap wordt verwijderd in aanmaakaanvragen
De email eigenschap en het verbonden e-mailmeldingsproces worden verwijderd uit de API.
Eindpunten
De API voor het ophalen en verwijderen van logboekbestanden van eindpuntlogboeken wordt verwijderd. Aangepaste spraak ondersteunt nu BYOS (Bring Your Own Storage). Alleen accounts waarvoor BYOS is ingeschakeld, kunnen logboekregistratie inschakelen op modeleindpunten. Dit biedt volledige beheerbaarheid van logboekbestanden in de opslag van klanten in plaats van een proxy-API.
Ondersteuning voor timeToLive het maken van eindpunten is verwijderd.
De text eigenschap in een aanvraag voor het maken van een eindpunt is verwijderd. Het alternatief is om een gegevensset te maken met de tekstinhoud en eerst een gegevensset te maken, die later wordt gebruikt voor het maken van modellen. Dit model kan vervolgens worden gebruikt om een eindpunt te maken.
Eindpuntkoppelingen retourneren nu alleen het eindpunt van de websocket-verbinding, die wordt gebruikt voor SDK.
De project eigenschap wordt verwijderd in aanmaakaanvragen.
De email eigenschap en het verbonden e-mailmeldingsproces worden verwijderd uit de API.
Transcripties
De eigenschap op het hoogste niveau diarizationEnabled van een transcriptie is verwijderd. De diarisatieconfiguratie is vereenvoudigd tot "diarization": {"maxSpeakers": 2,"enabled": true}. De maxSpeakers eigenschap is optioneel en wordt standaard ingesteld op 2. De enabled eigenschap is vereist voor diarisatie.
Transcriptie maken: timeToLive hernoemd tot timeToLiveHours het opnemen van een opmaakwijziging van ISO8601 opgemaakte tekenreeks naar een eenvoudige int (aantal uren).
De duration eigenschap in transcriptieantwoorden wordt gewijzigd van duration in durationMilliseconds en is nu een gewoon getal in plaats van een ISO8601 opgemaakte tekenreeks (P1D2H3M4S...) om de verwerking verder te vereenvoudigen. Transcriptieresultaatbestanden hebben deze eigenschap toegevoegd voor consistentie met API.
De naam van de queryparameter sasValidityInSeconds wordt gewijzigd om bestanden op te sasLifetimeMinutes halen. Gebruik is alleen toegestaan voor een account waarvoor BYOS is uitgeschakeld. Voor ACCOUNTS waarvoor BYOS is ingeschakeld, worden SAS-URL's niet geretourneerd.
De project eigenschap wordt verwijderd in aanmaakaanvragen.
De email eigenschap en het verbonden e-mailmeldingsproces worden verwijderd uit de API.
Projecten
De project-API wordt verwijderd.