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
endpoint	path	True	string	支援的認知服務端點（通訊協定和主機名，例如：https://eastus.api.cognitive.microsoft.com）。
id	path	True	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	資源的標識碼。
api-version	query	True	string minLength: 1	要用於這項作業的 API 版本。

要求標頭

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

要求本文

名稱	必要	類型	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	錯誤回應遵循 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

Object

Azure Blob 記憶體內容。在下面的範例中，它表示檔 https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

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

Dataset

Object

數據集物件

名稱	類型	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
LongAudio
AudioOnly

Error

Object

最上層錯誤遵循 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	錯誤的來源。例如，如果是無效的模型，則為 “model” 或 “model id”。

ErrorCode

列舉型別

最上層錯誤碼

值	Description
BadRequest
BadArgument
Unauthorized
Forbidden
NotFound
UnsupportedMediaType
TooManyRequests
InternalServerError
ServiceUnavailable

ErrorResponse

Object

錯誤回應遵循 Microsoft Azure REST API 指導方針，可在 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

Object

內部錯誤遵循 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	錯誤的來源。例如，如果是無效的模型，則為 “model” 或 “model id”。

共用方式為

Training Sets - Upload Data

URI 參數

要求標頭

要求本文

回應

安全性

Ocp-Apim-Subscription-Key

範例

Upload data to a training set

範例要求

範例回覆

定義

AzureBlobContentSource

Dataset

DatasetKind

Error

ErrorCode

ErrorResponse

InnerError