v3.2 からバージョン 2024-11-15 にコードを移行する
Speech to Text REST API は、ファスト トランスクリプション、バッチ文字起こし、カスタム音声のために使用されます。 この記事では、バージョン 3.2 からバージョン 2024-11-15 への変更について説明します。
重要
Speech to Text REST API バージョン 2024-11-15 は、一般提供されている最新バージョンです。
- Speech to Text REST API バージョン
2024-05-15-previewの廃止日は後日発表されます。 - Speech to Text REST API
v3.0、v3.1、v3.2、3.2-preview.1、3.2-preview.2は、2026 年 4 月 1 日に廃止されます。
アップグレードの詳細については、Speech to Text REST API の v3.0 から v3.1、v3.1 から v3.2、v3.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 操作には、常に 0 以外の 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 が削除されています。