Eseguire la migrazione del codice dalla versione 3.2 alla versione 2024-11-15
L'API REST Riconoscimento vocale viene usata per trascrizione rapida, trascrizione batch e riconoscimento vocale personalizzato. Questo articolo descrive le modifiche dalla versione 3.2 alla versione 2024-11-15.
Importante
La versione 2024-11-15 dell'API REST riconoscimento vocale è la versione più recente disponibile a livello generale.
- La versione
2024-05-15-previewdell'API REST riconoscimento vocale verrà ritirata in una data da annunciare. - L'API
v3.0REST riconoscimento vocale, ,v3.1v3.2,3.2-preview.1e3.2-preview.2verrà ritirata il 1° aprile 2026.
Per altre informazioni sull'aggiornamento, vedere Le guide alla migrazione dell'API REST Riconoscimento vocale v3.0 alla versione 3.1, dalla versione 3.1 alla versione 3.2 e dalla versione 3.2 alla versione 2024-11-15.
Percorso base
L'API di riconoscimento vocale personalizzato passa da uno schema di controllo delle versioni basato su percorso a uno schema basato su parametri di query in linea con gli schemi di controllo delle versioni delle API di Azure generali. Questa operazione richiedeva modifiche al percorso di base usato. Aggiornare il percorso da /speechtotext/v3.2 a /speechtotext e aggiungere la versione dell'API con ?api-version=2024-11-15 a tutte le richieste.
Set di dati
La email proprietà e il processo di notifica tramite posta elettronica connessa vengono rimossi dall'API.
La duration proprietà nelle risposte del set di dati viene rinominata da duration a durationMilliseconds e ora è un numero normale anziché una stringa formattata ISO8601 (P1D2H3M4S...) per eseguire ulteriormente l'elaborazione.
Il parametro sasValidityInSeconds di query viene rinominato in sasLifetimeMinutes per il recupero di file. L'utilizzo è consentito solo per un account con BYOS disabilitato. Per gli account abilitati per BYOS, gli URL di firma di accesso condiviso non vengono restituiti.
La project proprietà viene rimossa nelle richieste di creazione.
Modelli
Rimossa la text proprietà in una richiesta di creazione del modello. L'alternativa consiste nel creare un set di dati con il contenuto di testo e creare prima un set di dati, che viene quindi usato successivamente per la creazione del modello.
La email proprietà e il processo di notifica tramite posta elettronica connessa vengono rimossi dall'API.
Il parametro sasValidityInSeconds di query viene rinominato in sasLifetimeMinutes per il recupero di file. L'utilizzo è consentito solo per un account con BYOS (bring your own storage) disabilitato. Per gli account abilitati per BYOS, gli URL di firma di accesso condiviso non vengono restituiti.
L'operazione GET models/id/manifest richiede ora sempre una durata di firma di accesso condiviso diverso da zero. La proprietà corrispondente sasValidityInSeconds viene rinominata in sasLifetimeMinutes.
La project proprietà viene rimossa nelle richieste di creazione.
Valutazioni
Il parametro sasValidityInSeconds di query viene rinominato in sasLifetimeMinutes per il recupero di file. L'utilizzo è consentito solo per un account con BYOS disabilitato. Per gli account abilitati per BYOS, gli URL di firma di accesso condiviso non vengono restituiti.
La project proprietà viene rimossa nelle richieste di creazione
La email proprietà e il processo di notifica tramite posta elettronica connessa vengono rimossi dall'API.
Endpoint
L'API per recuperare ed eliminare i file di log dei log degli endpoint viene rimossa. Il riconoscimento vocale personalizzato supporta ora BYOS (bring your own storage). Solo gli account con BYOS abilitato possono abilitare la registrazione sugli endpoint del modello. Ciò offre la gestibilità completa dei file di log nell'archiviazione dei clienti anziché un'API proxy.
Rimozione del supporto per timeToLive nelle creazioni di endpoint.
Rimossa la text proprietà in una richiesta di creazione dell'endpoint. L'alternativa consiste nel creare un set di dati con il contenuto di testo e creare prima un set di dati, che viene quindi usato successivamente per la creazione del modello. Questo modello può quindi essere usato per creare un endpoint.
I collegamenti endpoint ora restituiscono solo l'endpoint della connessione websocket, usato per l'SDK.
La project proprietà viene rimossa nelle richieste di creazione.
La email proprietà e il processo di notifica tramite posta elettronica connessa vengono rimossi dall'API.
Trascrizioni
Rimossa la proprietà di primo livello diarizationEnabled di una trascrizione. La configurazione della diarizzazione è semplificata in "diarization": {"maxSpeakers": 2,"enabled": true}. La maxSpeakers proprietà è facoltativa e il valore predefinito è 2. La enabled proprietà è obbligatoria per la diarizzazione.
Creazione della trascrizione: timeToLive rinominata per timeToLiveHours includere una modifica del formato da ISO8601 stringa formattata a una semplice int (numero di ore).
La duration proprietà nelle risposte di trascrizione viene rinominata da duration a durationMilliseconds e ora è un numero normale anziché una stringa formattata ISO8601 (P1D2H3M4S...) per semplificare ulteriormente l'elaborazione. I file dei risultati della trascrizione hanno questa proprietà aggiunta per coerenza con l'API.
Il parametro sasValidityInSeconds di query viene rinominato in sasLifetimeMinutes per il recupero di file. L'utilizzo è consentito solo per un account con BYOS disabilitato. Per gli account abilitati per BYOS, gli URL di firma di accesso condiviso non vengono restituiti.
La project proprietà viene rimossa nelle richieste di creazione.
La email proprietà e il processo di notifica tramite posta elettronica connessa vengono rimossi dall'API.
Progetti
L'API dei progetti viene rimossa.