你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

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	支持的认知服务终结点（协议和主机名，例如：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]$	资源的 ID。
api-version	query	True	string minLength: 1	用于此作的 API 版本。

请求头

名称	必需	类型	说明
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]$	作的状态监视器的 ID。如果 Operation-Id 标头与现有作匹配，并且请求与以前的请求不同，则请求将失败并出现 400 错误请求。

请求正文

名称	必需	类型	说明
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`

响应

名称	类型	说明
202 Accepted		接受标头 Operation-Id: string Operation-Location: string
Other Status Codes	ErrorResponse	发生错误。标头 x-ms-error-code: string

名称

类型

说明

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

定义

名称	说明
AzureBlobContentSource	Azure Blob 存储内容。在下面的示例中，它表示文件 `https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav`
Dataset	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

名称	类型	说明
containerUrl	string (url)	具有 SAS的 Azure Blob 存储容器 URL。需要读取权限和列表权限。
extensions	string[]	文件扩展名。
prefix	string	Blob 名称前缀。

Dataset

Object

Dataset 对象

名称	类型	说明
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

枚举

数据集类型

值	说明
AudioAndScript
AudioOnly
LongAudio

Error

Object

顶级错误遵循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
BadRequest
Forbidden
InternalServerError
NotFound
ServiceUnavailable
TooManyRequests
Unauthorized
UnsupportedMediaType

ErrorResponse

Object

错误响应遵循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

Object

内部错误遵循 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”。

通过

Training Sets - Upload Data

URI 参数

请求头

请求正文

响应

安全性

Ocp-Apim-Subscription-Key

示例

Upload data to a training set

示例请求

示例响应

定义

AzureBlobContentSource

Dataset

DatasetKind

Error

ErrorCode

ErrorResponse

InnerError