Migración de código de la versión 3.2 a la 2024-11-15
La API de REST de conversión de voz en texto se usa para transcripción rápida, transcripción por lotes, y voz personalizada. En este artículo, se describen los cambios de la versión 3.2 a la 2024-11-15.
Importante
La versión de la API de REST de conversión de voz en texto es 2024-11-15 la versión más reciente que está disponible con carácter general.
- La versión de la API de REST de conversión de voz en texto
2024-05-15-previewse retirará en una fecha que se anunciará. - La API de REST de conversión de voz en texto
v3.0,v3.1,v3.2,3.2-preview.1, y3.2-preview.2se retirarán el 1 de abril de 2026.
Para obtener más información acerca de la actualización, consulte las guías de migración de la Conversión de voz en texto de la API de REST de v3.0 a v3.1, v3.1 a v3.2 y v3.2 a 2024-11-15.
Ruta de acceso base
La API de habla personalizada cambió de un esquema de control de versiones basado en ruta de acceso a un esquema basado en parámetros de consulta en consonancia con los esquemas generales de control de versiones de la API de Azure. Esto necesitó cambios en la ruta de acceso base usada. Actualice la ruta de acceso de /speechtotext/v3.2 a /speechtotext y anexe la versión de la API con ?api-version=2024-11-15 en todas las solicitudes.
Conjuntos de datos
La propiedad email y el proceso de notificación de correo electrónico conectado se han eliminado de la API.
El nombre de la propiedad duration en las respuestas del conjunto de datos se ha cambiado de duration a durationMilliseconds, y ahora es un número sin formato, en lugar de una cadena con formato ISO8601 (P1D2H3M4S…) para simplificar el proceso.
El nombre del parámetro de consulta sasValidityInSeconds se ha cambiado a sasLifetimeMinutes para obtener archivos. El uso solo se permite para una cuenta con BYOS deshabilitado. En el caso de las cuentas con BYOS habilitado, no se devuelven direcciones URL de SAS.
La propiedad project se ha eliminado en las solicitudes de creación.
Models
Se ha eliminado la propiedad text en una solicitud de creación de modelos. La alternativa es crear un conjunto de datos con el contenido de texto; primero se crea el conjunto de datos y se usa más adelante para la creación del modelo.
La propiedad email y el proceso de notificación de correo electrónico conectado se han eliminado de la API.
El nombre del parámetro de consulta sasValidityInSeconds se ha cambiado a sasLifetimeMinutes para obtener archivos. El uso solo se permite para una cuenta con BYOS (Traiga su propio almacenamiento) deshabilitado. En el caso de las cuentas con BYOS habilitado, no se devuelven direcciones URL de SAS.
La operación de GET models/id/manifest ahora siempre requiere una duración de SAS distinta de cero. El nombre de la propiedad sasValidityInSeconds correspondiente se cambia a sasLifetimeMinutes.
La propiedad project se ha eliminado en las solicitudes de creación.
Evaluaciones
El nombre del parámetro de consulta sasValidityInSeconds se ha cambiado a sasLifetimeMinutes para obtener archivos. El uso solo se permite para una cuenta con BYOS deshabilitado. En el caso de las cuentas con BYOS habilitado, no se devuelven direcciones URL de SAS.
La propiedad project se ha eliminado en las solicitudes de creación
La propiedad email y el proceso de notificación de correo electrónico conectado se han eliminado de la API.
Puntos de conexión
La API para recuperar y eliminar archivos de registro de los registros de punto de conexión se ha eliminado. La voz personalizada ahora admite BYOS (Traiga su propio almacenamiento). Solo las cuentas con BYOS habilitado pueden habilitar el registro en los puntos de conexión del modelo. Esto permite una capacidad de administración completa de los archivos de registro en el almacenamiento del cliente, en lugar de una API de proxy.
Se ha eliminado la compatibilidad con timeToLive en las creaciones de puntos de conexión.
Se ha eliminado la propiedad text en una solicitud de creación de puntos de conexión. La alternativa es crear un conjunto de datos con el contenido de texto; primero se crea el conjunto de datos y se usa más adelante para la creación del modelo. A continuación, este modelo se puede usar para crear un punto de conexión.
Los vínculos de punto de conexión ahora solo devuelven el punto de la conexión de WebSocket, que se usa para el SDK.
La propiedad project se ha eliminado en las solicitudes de creación.
La propiedad email y el proceso de notificación de correo electrónico conectado se han eliminado de la API.
Transcripciones
Se ha eliminado la propiedad diarizationEnabled de nivel superior de una transcripción. La configuración de la diarización se ha simplificado a "diarization": {"maxSpeakers": 2,"enabled": true}. La propiedad maxSpeakers es opcional y el valor predeterminado es 2. La propiedad enabled es obligatoria para la diarización.
Creación de transcripciones: se ha cambiado el nombre de timeToLive a timeToLiveHours, que incluye un cambio de formato de la cadena con formato ISO8601 a un valor int simple (número de horas).
El nombre de la propiedad duration en las respuestas de transcripción se ha cambiado de duration a durationMilliseconds, y ahora es un número sin formato, en lugar de una cadena con formato ISO8601 (P1D2H3M4S…) para simplificar el proceso. Los archivos de resultados de transcripción tienen esta propiedad agregada para garantizar la coherencia con la API.
El nombre del parámetro de consulta sasValidityInSeconds se ha cambiado a sasLifetimeMinutes para obtener archivos. El uso solo se permite para una cuenta con BYOS deshabilitado. En el caso de las cuentas con BYOS habilitado, no se devuelven direcciones URL de SAS.
La propiedad project se ha eliminado en las solicitudes de creación.
La propiedad email y el proceso de notificación de correo electrónico conectado se han eliminado de la API.
Proyectos
Se ha eliminado la API de proyectos.