Dela via

Migrera kod från v3.2 till version 2024-11-15

  • Artikel

REST API för tal till text används för snabb transkription, batch-transkription och anpassat tal. I den här artikeln beskrivs ändringar från version 3.2 till version 2024-11-15.

Viktigt!

Rest API-versionen 2024-11-15 för tal till text är den senaste versionen som är allmänt tillgänglig.

  • Rest API-versionen 2024-05-15-preview för tal till text dras tillbaka vid ett datum som ska tillkännages.
  • Tal till text REST API v3.0, v3.1, v3.2, 3.2-preview.1och 3.2-preview.2 kommer att dras tillbaka den 1 april 2026.

Mer information om uppgradering finns i rest-API :et för tal till text v3.0 till v3.1, v3.1 till v3.2 och v3.2 till 2024-11-15 .

Bassökväg

Anpassat tal-API växlade från ett sökvägsbaserat versionsschema till ett frågeparameterbaserat schema i linje med allmänna Versionsscheman för Azure API. Detta krävde ändringar i den använda bassökvägen. Uppdatera sökvägen från /speechtotext/v3.2 till /speechtotext och lägg till API-versionen med ?api-version=2024-11-15 till alla begäranden.

Datauppsättningar

Egenskapen email och den anslutna e-postaviseringsprocessen tas bort från API:et.

Egenskapen duration i datauppsättningssvaren byts namn från duration till durationMilliseconds och är nu ett vanligt tal i stället för en ISO8601 formaterad sträng (P1D2H3M4S...) för ytterligare bearbetning.

Frågeparametern sasValidityInSeconds har bytt namn till för att sasLifetimeMinutes hämta filer. Användning tillåts endast för ett konto med BYOS inaktiverat. FÖR BYOS-aktiverade konton returneras inte SAS-URL:er.

Egenskapen project tas bort i begäranden om att skapa.

Modeller

Egenskapen har tagits text bort i en begäran om att skapa en modell. Alternativet är att skapa en datauppsättning med textinnehållet och först skapa en datauppsättning, som sedan används senare för att skapa modellen.

Egenskapen email och den anslutna e-postaviseringsprocessen tas bort från API:et.

Frågeparametern sasValidityInSeconds har bytt namn till för att sasLifetimeMinutes hämta filer. Användning tillåts endast för ett konto med BYOS (bring your own storage) inaktiverat. FÖR BYOS-aktiverade konton returneras inte SAS-URL:er.

Åtgärden GET models/id/manifest kräver nu alltid en sas-livslängd som inte är noll. Motsvarande sasValidityInSeconds egenskap har bytt namn till sasLifetimeMinutes.

Egenskapen project tas bort i begäranden om att skapa.

Recensioner

Frågeparametern sasValidityInSeconds har bytt namn till för att sasLifetimeMinutes hämta filer. Användning tillåts endast för ett konto med BYOS inaktiverat. FÖR BYOS-aktiverade konton returneras inte SAS-URL:er.

Egenskapen project tas bort i begäranden om att skapa

Egenskapen email och den anslutna e-postaviseringsprocessen tas bort från API:et.

Slutpunkter

API:et för att hämta och ta bort loggfiler för slutpunktsloggar tas bort. Anpassat tal har nu stöd för BYOS (bring your own storage). Endast konton med BYOS aktiverat kan aktivera loggning på modellslutpunkter. Detta ger fullständig hanterbarhet för loggfiler på kundlagring i stället för ett proxy-API.

Stöd har tagits bort för timeToLive att skapa slutpunkter.

Egenskapen har tagits text bort i en begäran om att skapa slutpunkter. Alternativet är att skapa en datauppsättning med textinnehållet och först skapa en datauppsättning, som sedan används senare för att skapa modellen. Den här modellen kan sedan användas för att skapa en slutpunkt.

Slutpunktslänkar returnerar nu bara slutpunkten för websocket-anslutning, som används för SDK.

Egenskapen project tas bort i begäranden om att skapa.

Egenskapen email och den anslutna e-postaviseringsprocessen tas bort från API:et.

Transkriptioner

Den översta egenskapen för diarizationEnabled en transkription har tagits bort. Diariseringskonfigurationen förenklas till "diarization": {"maxSpeakers": 2,"enabled": true}. Egenskapen maxSpeakers är valfri och standardvärdet är 2. Egenskapen enabled krävs för diarisering.

Skapande av transkription: timeToLive har bytt namn till att timeToLiveHours inkludera en formatändring från ISO8601 formaterad sträng till en enkel int (antal timmar).

Egenskapen duration i transkriptionssvar byter namn från duration till durationMilliseconds och är nu ett vanligt tal i stället för en ISO8601 formaterad sträng (P1D2H3M4S...) för att ytterligare förenkla bearbetningen. Transkriptionsresultatfiler har den här egenskapen tillagd för konsekvens med API.

Frågeparametern sasValidityInSeconds har bytt namn till för att sasLifetimeMinutes hämta filer. Användning tillåts endast för ett konto med BYOS inaktiverat. FÖR BYOS-aktiverade konton returneras inte SAS-URL:er.

Egenskapen project tas bort i begäranden om att skapa.

Egenskapen email och den anslutna e-postaviseringsprocessen tas bort från API:et.

Projekt

Projekt-API:et tas bort.

Nästa steg