Training Sets - Upload Data

サービス:

Azure AI Services

API バージョン:

2024-02-01-preview

指定したトレーニング セットにデータをアップロードします。

POST {endpoint}/customvoice/trainingsets/{id}:upload?api-version=2024-02-01-preview

URI パラメーター

名前	/	必須	型	説明
endpoint	path	True	string	サポートされている Cognitive Services エンドポイント (プロトコルとホスト名など)。 https://eastus.api.cognitive.microsoft.com
id	path	True	string	リソースの ID。 正規表現パターン: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$
api-version	query	True	string	この操作に使用する API バージョン。

要求ヘッダー

名前	必須	型	説明
Ocp-Apim-Subscription-Key	True	string	Speech リソース キーをここに入力します。
Operation-Id		string	操作の状態モニターの ID。 Operation-Id ヘッダーが既存の操作と一致し、要求が以前の要求と同じでない場合、400 Bad Request で失敗します。 正規表現パターン: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$

要求本文

名前	必須	型	説明
audios	True	AzureBlobContentSource	Azure Blob Storage のコンテンツ。 次の例では、ファイル https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
kind	True	DatasetKind	データセットの種類
description		string	このデータセットの説明 (省略可能)。
displayName		string	このデータセットの名前。
scripts		AzureBlobContentSource	Azure Blob Storage のコンテンツ。 次の例では、ファイル https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

応答

名前	型	説明
202 Accepted		同意 ヘッダー Operation-Id: string Operation-Location: string
Other Status Codes	ErrorResponse	エラーが発生しました。 ヘッダー x-ms-error-code: string

セキュリティ

Ocp-Apim-Subscription-Key

Speech リソース キーをここに入力します。

型: apiKey
/: header

例

Upload data to a training set

要求のサンプル

HTTP

POST {endpoint}/customvoice/trainingsets/d6916a55-2cbc-4ed4-bd19-739e9a13b0ab:upload?api-version=2024-02-01-preview



{
  "kind": "AudioAndScript",
  "audios": {
    "containerUrl": "https://contoso.blob.core.windows.net/voicecontainer?mySasToken",
    "prefix": "jessica300/",
    "extensions": [
      ".wav"
    ]
  },
  "scripts": {
    "containerUrl": "https://contoso.blob.core.windows.net/voicecontainer?mySasToken",
    "prefix": "jessica300/",
    "extensions": [
      ".txt"
    ]
  }
}

応答のサンプル

状態コード:

202

Operation-Location: https://eastus.api.cognitive.microsoft.com/customvoice/operations/284b7e37-f42d-4054-8fa9-08523c3de345?api-version=2024-02-01-preview
Operation-Id: 284b7e37-f42d-4054-8fa9-08523c3de345

定義

名前	説明
AzureBlobContentSource	Azure Blob Storage のコンテンツ。 次の例では、ファイル https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
Dataset	データセット オブジェクト
DatasetKind	データセットの種類
Error	最上位レベルのエラーは、 で利用可能な Microsoft Azure REST API ガイドラインに https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors従います。 これには、エラー コード、メッセージ、詳細、ターゲット、およびよりわかりやすい詳細を含む内部エラーを含む最上位レベルのエラーが含まれます。
ErrorCode	最上位のエラー コード
ErrorResponse	エラー応答は、 で入手できる Microsoft Azure REST API ガイドラインに https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors従います。
InnerError	内部エラーは、 で入手できる Microsoft Azure REST API ガイドラインに https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors従います。 これには、必須プロパティのエラー コード、メッセージ、およびオプションのプロパティ ターゲット、内部エラー (入れ子にできます) が含まれます。

AzureBlobContentSource

Azure Blob Storage のコンテンツ。 次の例では、ファイル https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

名前	型	説明
containerUrl	string	SAS を使用した Azure Blob Storage コンテナー URL。 読み取りと一覧表示の両方のアクセス許可が必要です。
extensions	string[]	ファイル名拡張子。
prefix	string	BLOB 名プレフィックス。

Dataset

データセット オブジェクト

名前	型	説明
audios	AzureBlobContentSource	Azure Blob Storage のコンテンツ。 次の例では、ファイル https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
description	string	このデータセットの説明 (省略可能)。
displayName	string	このデータセットの名前。
kind	DatasetKind	データセットの種類
scripts	AzureBlobContentSource	Azure Blob Storage のコンテンツ。 次の例では、ファイル https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

DatasetKind

データセットの種類

名前	型	説明
AudioAndScript	string
AudioOnly	string
LongAudio	string

Error

最上位レベルのエラーは、 で利用可能な Microsoft Azure REST API ガイドラインに https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors従います。 これには、エラー コード、メッセージ、詳細、ターゲット、およびよりわかりやすい詳細を含む内部エラーを含む最上位レベルのエラーが含まれます。

名前	型	説明
code	ErrorCode	最上位のエラー コード
details	Error[]	エラーや予想されるポリシーに関する追加のサポートの詳細。
innererror	InnerError	内部エラーは、 で入手できる Microsoft Azure REST API ガイドラインに https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors従います。 これには、必須プロパティのエラー コード、メッセージ、およびオプションのプロパティ ターゲット、内部エラー (入れ子にできます) が含まれます。
message	string	最上位レベルのエラー メッセージ。
target	string	エラーのソースです。 たとえば、無効なモデルの場合は、"model" または "model id" になります。

ErrorCode

最上位のエラー コード

名前	型	説明
BadArgument	string
BadRequest	string
Forbidden	string
InternalServerError	string
NotFound	string
ServiceUnavailable	string
TooManyRequests	string
Unauthorized	string
UnsupportedMediaType	string

ErrorResponse

エラー応答は、 で入手できる Microsoft Azure REST API ガイドラインに https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors従います。

名前	型	説明
error	Error	最上位レベルのエラーは、 で利用可能な Microsoft Azure REST API ガイドラインに https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors従います。 これには、エラー コード、メッセージ、詳細、ターゲット、およびよりわかりやすい詳細を含む内部エラーを含む最上位レベルのエラーが含まれます。

InnerError

内部エラーは、 で入手できる Microsoft Azure REST API ガイドラインに https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors従います。 これには、必須プロパティのエラー コード、メッセージ、およびオプションのプロパティ ターゲット、内部エラー (入れ子にできます) が含まれます。

名前	型	説明
code	string	診断に役立つ詳細なエラー コード。
innererror	InnerError	内部エラーは、 で入手できる Microsoft Azure REST API ガイドラインに https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors従います。 これには、必須プロパティのエラー コード、メッセージ、およびオプションのプロパティ ターゲット、内部エラー (入れ子にできます) が含まれます。
message	string	詳細なエラー メッセージ。
target	string	エラーのソースです。 たとえば、無効なモデルの場合は、"model" または "model id" になります。