Training Sets - Upload Data

Serviço:: Azure AI Services

Versão da API:: 2024-02-01-preview

Carrega dados para o conjunto de treinamento especificado.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
endpoint	path	True	string	Pontos de extremidade de Serviços Cognitivos suportados (protocolo e nome do host, por exemplo: 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]$	A ID do recurso.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Cabeçalho do Pedido

Name	Necessário	Tipo	Description
Ocp-Apim-Subscription-Key	True	string	Forneça sua chave de recurso de fala aqui.
Operation-Id		string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	ID do monitor de status da operação. Se o cabeçalho Operation-Id corresponder a uma operação existente e a solicitação não for idêntica à solicitação anterior, ela falhará com uma solicitação incorreta de 400.

Corpo do Pedido

Name	Necessário	Tipo	Description
audios	True	AzureBlobContentSource	Conteúdo do Armazenamento de Blobs do Azure. Com os exemplos abaixo, ele representa arquivos `https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav`
kind	True	DatasetKind	Tipo de conjunto de dados
description		string	Descrição opcional deste conjunto de dados.
displayName		string	O nome deste conjunto de dados.
scripts		AzureBlobContentSource	Conteúdo do Armazenamento de Blobs do Azure. Com os exemplos abaixo, ele representa arquivos `https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav`

Respostas

Name	Tipo	Description
202 Accepted		Aceito Cabeçalhos Operation-Id: string Operation-Location: string
Other Status Codes	ErrorResponse	Ocorreu um erro. Cabeçalhos x-ms-error-code: string

Name

Tipo

Description

202 Accepted

Aceito

Cabeçalhos

Operation-Id: string
Operation-Location: string

Other Status Codes

ErrorResponse

Ocorreu um erro.

Cabeçalhos

x-ms-error-code: string

Segurança

Ocp-Apim-Subscription-Key

Forneça sua chave de recurso de fala aqui.

Tipo: apiKey
Em: header

Exemplos

Upload data to a training set

Pedido de amostra

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"
    ]
  }
}

Resposta da amostra

Código de estado:: 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

Definições

Name	Description
AzureBlobContentSource	Conteúdo do Armazenamento de Blobs do Azure. Com os exemplos abaixo, ele representa arquivos `https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav`
Dataset	Objeto Dataset
DatasetKind	Tipo de conjunto de dados
Error	O erro de nível superior segue as Diretrizes da API REST do Microsoft Azure que estão disponíveis em https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Este contém um erro de nível superior com código de erro, mensagem, detalhes, destino e um erro interno com detalhes mais descritivos.
ErrorCode	Código de erro de nível superior
ErrorResponse	A resposta de erro segue as Diretrizes da API REST do Microsoft Azure que estão disponíveis em https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
InnerError	O erro interno segue as Diretrizes da API REST do Microsoft Azure que estão disponíveis em https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Isso contém código de erro de propriedades necessárias, mensagem e destino de propriedades opcionais, erro interno (isso pode ser aninhado).

AzureBlobContentSource

Object

Conteúdo do Armazenamento de Blobs do Azure. Com os exemplos abaixo, ele representa arquivos https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

Name	Tipo	Description
containerUrl	string (url)	URL do contêiner de Armazenamento de Blobs do Azure com SAS. Precisa de permissões de leitura e de lista.
extensions	string[]	Extensões de nome de arquivo.
prefix	string	Prefixo do nome do blob.

Dataset

Object

Objeto Dataset

Name	Tipo	Description
audios	AzureBlobContentSource	Conteúdo do Armazenamento de Blobs do Azure. Com os exemplos abaixo, ele representa arquivos `https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav`
description	string	Descrição opcional deste conjunto de dados.
displayName	string	O nome deste conjunto de dados.
kind	DatasetKind	Tipo de conjunto de dados
scripts	AzureBlobContentSource	Conteúdo do Armazenamento de Blobs do Azure. Com os exemplos abaixo, ele representa arquivos `https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav`

DatasetKind

Enumeração

Tipo de conjunto de dados

Valor	Description
AudioAndScript
LongAudio
AudioOnly

Error

Object

O erro de nível superior segue as Diretrizes da API REST do Microsoft Azure que estão disponíveis em https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Este contém um erro de nível superior com código de erro, mensagem, detalhes, destino e um erro interno com detalhes mais descritivos.

Name	Tipo	Description
code	ErrorCode	Código de erro de nível superior
details	Error[]	Detalhes adicionais de suporte sobre o erro e/ou políticas esperadas.
innererror	InnerError	O erro interno segue as Diretrizes da API REST do Microsoft Azure que estão disponíveis em https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Isso contém código de erro de propriedades necessárias, mensagem e destino de propriedades opcionais, erro interno (isso pode ser aninhado).
message	string	Mensagem de erro de nível superior.
target	string	A origem do erro. Por exemplo, seria "modelo" ou "id do modelo" no caso de modelo inválido.

ErrorCode

Enumeração

Código de erro de nível superior

Valor	Description
BadRequest
BadArgument
Unauthorized
Forbidden
NotFound
UnsupportedMediaType
TooManyRequests
InternalServerError
ServiceUnavailable

ErrorResponse

Object

A resposta de erro segue as Diretrizes da API REST do Microsoft Azure que estão disponíveis em https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Name	Tipo	Description
error	Error	O erro de nível superior segue as Diretrizes da API REST do Microsoft Azure que estão disponíveis em https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Este contém um erro de nível superior com código de erro, mensagem, detalhes, destino e um erro interno com detalhes mais descritivos.

InnerError

Object

O erro interno segue as Diretrizes da API REST do Microsoft Azure que estão disponíveis em https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Isso contém código de erro de propriedades necessárias, mensagem e destino de propriedades opcionais, erro interno (isso pode ser aninhado).

Name	Tipo	Description
code	string	Código de erro detalhado para ajudar no diagnóstico.
innererror	InnerError	O erro interno segue as Diretrizes da API REST do Microsoft Azure que estão disponíveis em https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Isso contém código de erro de propriedades necessárias, mensagem e destino de propriedades opcionais, erro interno (isso pode ser aninhado).
message	string	Mensagem de erro detalhada.
target	string	A origem do erro. Por exemplo, seria "modelo" ou "id do modelo" no caso de modelo inválido.

Partilhar via

Training Sets - Upload Data

Parâmetros do URI

Cabeçalho do Pedido

Corpo do Pedido

Respostas

Segurança

Ocp-Apim-Subscription-Key

Exemplos

Upload data to a training set

Pedido de amostra

Resposta da amostra

Definições

AzureBlobContentSource

Dataset

DatasetKind

Error

ErrorCode

ErrorResponse

InnerError