将代码从 v3.2 迁移到版本 2024-11-15

语音转文本 REST API 用于 快速听录、 批量听录和 自定义语音。 本文介绍版本 3.2 到版本 2024-11-15 的更改。

基础路径

自定义语音 API 从基于路径的版本控制方案切换到基于查询参数的方案，与常规 Azure API 版本控制方案一致。 这需要对已用基路径进行更改。 将路径从/speechtotext/v3.2更新为/speechtotext，并将 API 版本?api-version=2024-11-15附加到所有请求。

数据集

属性 email 和连接的电子邮件通知过程将从 API 中删除。

数据集中 duration 响应中的属性已从 duration 重命名为 durationMilliseconds，并且现在是一个纯数字，而不是 ISO8601 格式化的字符串（P1D2H3M4S...），从而简化处理过程。

查询参数 sasValidityInSeconds 已被重命名为 sasLifetimeMinutes，用于获取文件。 仅允许禁用 BYOS 的帐户使用。 对于已启用 BYOS 的帐户，不会返回 SAS URL。

在创建请求中移除了 project 属性。

模型

在模型创建请求中删除了text属性。 另一种方法是创建包含文本内容的数据集，并首先创建数据集，然后稍后将用于模型创建。

属性 email 和连接的电子邮件通知过程将从 API 中删除。

查询参数 sasValidityInSeconds 被重命名为 sasLifetimeMinutes 用以获取文件。 仅允许禁用了 BYOS（自带存储）的帐户使用。 对于已启用 BYOS 的帐户，不会返回 SAS URL。

GET models/id/manifest 操作现在始终需要非零 SAS 生存期。 sasValidityInSeconds相应的属性重命名为 sasLifetimeMinutes.

创建请求时删除project属性。

评估

查询参数 sasValidityInSeconds 已重命名为 sasLifetimeMinutes 用于获取文件。 仅允许禁用 BYOS 的帐户使用。 对于已启用 BYOS 的帐户，不会返回 SAS URL。

创建请求中会删除 project 属性。

属性 email 和连接的电子邮件通知过程将从 API 中删除。

端点

将删除用于检索和删除终结点日志日志文件的 API。 自定义语音现在支持 BYOS（自备存储）。 只有启用了 BYOS 的帐户才能在模型终结点上启用日志记录。 这提供客户存储（而不是代理 API）上的日志文件的完全可管理性。

删除了对 timeToLive 接口创建中的支持。

在终结点创建请求中已删除text属性。 另一种方法是创建包含文本内容的数据集，并首先创建数据集，然后稍后将用于模型创建。 然后，可以使用此模型来创建终结点。

终结点链接现在仅返回用于 SDK 的 Websocket 连接的终结点。

在创建请求中移除了 project 属性。

属性 email 和连接的电子邮件通知过程将从 API 中删除。

听录

删除了转录的顶级属性 diarizationEnabled。 分割配置简化为 "diarization": {"maxSpeakers": 2,"enabled": true}。 该 maxSpeakers 属性是可选的，默认值为 2。 enabled 属性是进行分割所必需的。

听录创建：timeToLive 重命名为 timeToLiveHours，包括将格式从 ISO8601 格式化字符串更改为简单 int（小时数）。

duration听录响应中的属性从duration重命名为durationMilliseconds，现在是一个纯数字，而不是ISO8601格式的字符串（P1D2H3M4S...），以进一步简化处理。 脚本结果文件添加了此属性，以便与 API 保持一致性。

为获取文件，查询参数 sasValidityInSeconds 已重命名为 sasLifetimeMinutes。 仅允许禁用 BYOS 的帐户使用。 对于已启用 BYOS 的帐户，不会返回 SAS URL。

创建请求时删除 project 的属性。

属性 email 和连接的电子邮件通知过程将从 API 中删除。

项目

项目 API 已删除。

后续步骤

• 语音转文本 REST API
• 语音转文本 REST API 2024-11-15 参考文档