將程式代碼從 v3.2 遷移至 2024-11-15 版

語音轉換文字 REST API 用於快速轉譯、批次轉譯和自定義語音。 本文說明從 3.2 版變更為 2024-11-15 版。

基底路徑

自定義語音 API 從路徑型版本設定設定切換至查詢參數型配置，以配合一般 Azure API 版本設定配置。 這需要變更所使用的基底路徑。 將 路徑從 /speechtotext/v3.2 更新為 ， /speechtotext 並將 ?api-version=2024-11-15 API 版本附加至所有要求。

資料集

屬性 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 的帳戶才能在模型端點上啟用記錄。 這會提供客戶記憶體上記錄檔的完整管理性，而不是 Proxy API。

已移除端點建立中的支援 timeToLive 。

text已移除端點建立要求中的屬性。 替代方法是使用文字內容建立數據集，並先建立數據集，稍後再用於建立模型。 此模型接著可用來建立端點。

端點連結現在只會傳回用於 SDK 的 websocket 連線端點。

在 project 建立要求中會移除 屬性。

屬性 email 和已連線的電子郵件通知程式會從 API 中移除。

文字記錄

已移除轉譯的最上層 diarizationEnabled 屬性。 diarization 組態已簡化為 "diarization": {"maxSpeakers": 2,"enabled": true}。 屬性 maxSpeakers 是選擇性的，預設為2。 需要 enabled 屬性才能進行 diarization。

轉譯建立： 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 參考檔