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 參數

名稱位於必要類型 Description

名稱	位於	必要	類型	Description
endpoint	path	True	string	支援的認知服務端點 (通訊協定和主機名，例如： https://eastus.api.cognitive.microsoft.com) 。
id	path	True	string	資源的標識碼。 Regex 模式: `^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$`
api-version	query	True	string	用於此作業的 API 版本。

endpoint

path

True

string

支援的認知服務端點 (通訊協定和主機名，例如： https://eastus.api.cognitive.microsoft.com) 。

path

True

string

資源的標識碼。

Regex 模式: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$

api-version

query

True

string

用於此作業的 API 版本。

要求標頭

名稱必要類型 Description

Ocp-Apim-Subscription-Key

True

名稱	必要	類型	Description
Ocp-Apim-Subscription-Key	True	string	在這裡提供您的語音資源金鑰。
Operation-Id		string	作業的狀態監視器標識碼。如果 Operation-Id 標頭符合現有的作業，且要求與先前的要求不相同，則會失敗並出現 400 錯誤的要求。 Regex 模式: `^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$`

string

在這裡提供您的語音資源金鑰。

Operation-Id

string

作業的狀態監視器標識碼。如果 Operation-Id 標頭符合現有的作業，且要求與先前的要求不相同，則會失敗並出現 400 錯誤的要求。

Regex 模式: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$

要求本文

名稱	必要	類型	Description
audios	True	AzureBlobContentSource	Azure Blob 記憶體內容。使用下列範例，它代表檔案https://contoso.blob.core.windows.net/voicecontainer/jessica/ *.wav
kind	True	DatasetKind	數據集種類
description		string	此數據集的選擇性描述。
displayName		string	此數據集的名稱。
scripts		AzureBlobContentSource	Azure Blob 記憶體內容。使用下列範例，它代表檔案https://contoso.blob.core.windows.net/voicecontainer/jessica/ *.wav

回應

名稱	類型	Description
202 Accepted		已接受標題 Operation-Id: string Operation-Location: string
Other Status Codes	ErrorResponse	發生錯誤。標題 x-ms-error-code: string

名稱

類型

Description

202 Accepted

已接受

標題

Operation-Id: string
Operation-Location: string

Other Status Codes

ErrorResponse

發生錯誤。

標題

x-ms-error-code: string

安全性

Ocp-Apim-Subscription-Key

在這裡提供您的語音資源金鑰。

類型: 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

定義

名稱	Description
AzureBlobContentSource	Azure Blob 記憶體內容。使用下列範例，它代表檔案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	錯誤回應遵循 azure REST API 指導方針Microsoft，可在取得 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 記憶體內容。使用下列範例，它代表檔案https://contoso.blob.core.windows.net/voicecontainer/jessica/ *.wav

名稱	類型	Description
containerUrl	string	具有 SAS的 Azure Blob 記憶體容器 URL。需要讀取和列出許可權。
extensions	string[]	擴展名。
prefix	string	Blob 名稱前置詞。

Dataset

資料集物件

名稱	類型	Description
audios	AzureBlobContentSource	Azure Blob 記憶體內容。使用下列範例，它代表檔案https://contoso.blob.core.windows.net/voicecontainer/jessica/ *.wav
description	string	此數據集的選擇性描述。
displayName	string	此數據集的名稱。
kind	DatasetKind	數據集種類
scripts	AzureBlobContentSource	Azure Blob 記憶體內容。使用下列範例，它代表檔案https://contoso.blob.core.windows.net/voicecontainer/jessica/ *.wav

DatasetKind

數據集種類

名稱	類型	Description
AudioAndScript	string
AudioOnly	string
LongAudio	string

Error

最上層錯誤遵循 Microsoft Azure REST API 指導方針，可在取得 https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors。這包含具有錯誤碼、訊息、詳細數據、目標和內部錯誤的最上層錯誤，其中包含更具描述性的詳細數據。

名稱	類型	Description
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	錯誤的來源。例如，如果是無效的模型，它會是「模型」或「模型標識碼」。

ErrorCode

最上層錯誤碼

名稱	類型	Description
BadArgument	string
BadRequest	string
Forbidden	string
InternalServerError	string
NotFound	string
ServiceUnavailable	string
TooManyRequests	string
Unauthorized	string
UnsupportedMediaType	string

ErrorResponse

錯誤回應遵循 azure REST API 指導方針Microsoft，可在取得 https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors。

名稱	類型	Description
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。這包含必要的屬性錯誤碼、訊息和選擇性屬性目標、內部錯誤 (這可以是巢狀) 。

名稱	類型	Description
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	錯誤的來源。例如，如果是無效的模型，它會是「模型」或「模型標識碼」。

共用方式為

Training Sets - Upload Data

URI 參數

要求標頭

要求本文

回應

安全性

Ocp-Apim-Subscription-Key

範例

Upload data to a training set

範例要求

範例回覆

定義

AzureBlobContentSource

Dataset

DatasetKind

Error

ErrorCode

ErrorResponse

InnerError

其他資源