你当前正在访问 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	资源的 ID。正则表达式模式: `^[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

资源的 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

名称	必需	类型	说明
Ocp-Apim-Subscription-Key	True	string	在此处提供语音资源密钥。
Operation-Id		string	操作的状态监视器的 ID。如果 Operation-Id 标头与现有操作匹配，并且请求与以前的请求不同，则失败并显示 400 错误请求。正则表达式模式: `^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$`

string

在此处提供语音资源密钥。

Operation-Id

string

操作的状态监视器的 ID。如果 Operation-Id 标头与现有操作匹配，并且请求与以前的请求不同，则失败并显示 400 错误请求。

正则表达式模式: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$

请求正文

名称	必需	类型	说明
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	数据集对象
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 存储内容。在以下示例中，它表示文件 https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

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

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	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”。

通过

Training Sets - Upload Data

URI 参数

请求头

请求正文

响应

安全性

Ocp-Apim-Subscription-Key

示例

Upload data to a training set

示例请求

示例响应

定义

AzureBlobContentSource

Dataset

DatasetKind

Error

ErrorCode

ErrorResponse

InnerError

其他资源