你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
将代码从 v3.2 迁移到版本 2024-11-15
语音转文本 REST API 用于快速听录、批量听录和自定义语音识别。 本文介绍版本 3.2 到 2024-11-15 的更改内容。
重要
语音转文本 REST API 版本 2024-11-15 是正式发布的最新版本。
- 语音转文本 REST API 版本
2024-05-15-preview即将停用，具体日期待宣布。 - 语音转文本 REST API
v3.0、v3.1、v3.2、3.2-preview.1和3.2-preview.2将于 2026 年 4 月 1 日停用。
有关升级的详细信息，请参阅语音转文本 REST API v3.0 到 v3.1、v3.1 到 v3.2 和 v3.2 到 2024-11-15 迁移指南。
基础路径
自定义语音 API 从基于路径的版本控制方案切换到基于查询参数的方案，与常规 Azure API 版本控制方案一致。 这需要对已用基础路径进行更改。 将 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 格式字符串更改为简单的整数（表示小时数）。
听录响应中的属性 duration 已从 duration 重命名为 durationMilliseconds，并且现在是一个普通数字，而不是 ISO8601 格式的字符串（如 P1D2H3M4S…），以进一步简化处理。 听录结果文件添加了此属性，以便与 API 保持一致性。
查询参数 sasValidityInSeconds 已重命名为 sasLifetimeMinutes 以获取文件。 仅允许禁用 BYOS 的帐户使用。 对于已启用 BYOS 的帐户，不会返回 SAS URL。
已在创建请求中删除 project 属性。
已将属性 email 和连接的电子邮件通知过程从 API 中删除。
项目
已删除项目 API。