Training Sets - Upload Data

Riferimento

Servizio:: Azure AI Services

Versione API:: 2024-02-01-preview

Carica i dati nel set di training specificato.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione

Nome	In	Necessario	Tipo	Descrizione
endpoint	path	True	string	Endpoint di Servizi cognitivi supportati (protocollo e nome host, ad esempio: https://eastus.api.cognitive.microsoft.com).
id	path	True	string	ID della risorsa. Criterio di espressione regolare: `^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$`
api-version	query	True	string	Versione dell'API da usare per questa operazione.

endpoint

path

True

string

Endpoint di Servizi cognitivi supportati (protocollo e nome host, ad esempio: https://eastus.api.cognitive.microsoft.com).

path

True

string

ID della risorsa.

Criterio di espressione regolare: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$

api-version

query

True

string

Versione dell'API da usare per questa operazione.

Intestazione della richiesta

Nome Necessario Tipo Descrizione

Ocp-Apim-Subscription-Key

True

Nome	Necessario	Tipo	Descrizione
Ocp-Apim-Subscription-Key	True	string	Specificare qui la chiave della risorsa Voce.
Operation-Id		string	ID del monitoraggio dello stato per l'operazione. Se l'intestazione Operation-Id corrisponde a un'operazione esistente e la richiesta non è identica alla richiesta precedente, avrà esito negativo con una richiesta non valida 400. Criterio di espressione regolare: `^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$`

string

Specificare qui la chiave della risorsa Voce.

Operation-Id

string

ID del monitoraggio dello stato per l'operazione. Se l'intestazione Operation-Id corrisponde a un'operazione esistente e la richiesta non è identica alla richiesta precedente, avrà esito negativo con una richiesta non valida 400.

Criterio di espressione regolare: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
audios	True	AzureBlobContentSource	Contenuto di Archiviazione BLOB di Azure. Con gli esempi seguenti, rappresenta i file https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
kind	True	DatasetKind	Tipo di set di dati
description		string	Descrizione facoltativa del set di dati.
displayName		string	Nome del set di dati.
scripts		AzureBlobContentSource	Contenuto di Archiviazione BLOB di Azure. Con gli esempi seguenti, rappresenta i file https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

Risposte

Nome	Tipo	Descrizione
202 Accepted		Accettato Intestazioni Operation-Id: string Operation-Location: string
Other Status Codes	ErrorResponse	Si è verificato un errore. Intestazioni x-ms-error-code: string

Nome

Tipo

Descrizione

202 Accepted

Accettato

Intestazioni

Operation-Id: string
Operation-Location: string

Other Status Codes

ErrorResponse

Si è verificato un errore.

Intestazioni

x-ms-error-code: string

Sicurezza

Ocp-Apim-Subscription-Key

Specificare qui la chiave della risorsa Voce.

Tipo: apiKey
In: header

Esempio

Upload data to a training set

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 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

Definizioni

Nome	Descrizione
AzureBlobContentSource	Contenuto di Archiviazione BLOB di Azure. Con gli esempi seguenti, rappresenta i file https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
Dataset	Oggetto Dataset
DatasetKind	Tipo di set di dati
Error	L'errore di primo livello segue le linee guida per l'API REST di Microsoft Azure disponibili in https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Contiene un errore di primo livello con codice di errore, messaggio, dettagli, destinazione e un errore interno con dettagli più descrittivi.
ErrorCode	Codice di errore di primo livello
ErrorResponse	La risposta agli errori segue le linee guida per l'API REST di Microsoft Azure disponibili in https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
InnerError	L'errore interno segue le linee guida dell'API REST di Microsoft Azure disponibili in https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Contiene il codice di errore delle proprietà necessarie, la destinazione del messaggio e le proprietà facoltative, l'errore interno(può essere annidato).

AzureBlobContentSource

Contenuto di Archiviazione BLOB di Azure. Con gli esempi seguenti, rappresenta i file https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

Nome	Tipo	Descrizione
containerUrl	string	URL del contenitore di Archiviazione BLOB di Azure con firma di accesso condiviso. Sono necessarie autorizzazioni sia di lettura che di elenco.
extensions	string[]	Estensioni del nome file.
prefix	string	Prefisso del nome DEL BLOB.

Dataset

Oggetto Dataset

Nome	Tipo	Descrizione
audios	AzureBlobContentSource	Contenuto di Archiviazione BLOB di Azure. Con gli esempi seguenti, rappresenta i file https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
description	string	Descrizione facoltativa del set di dati.
displayName	string	Nome del set di dati.
kind	DatasetKind	Tipo di set di dati
scripts	AzureBlobContentSource	Contenuto di Archiviazione BLOB di Azure. Con gli esempi seguenti, rappresenta i file https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

DatasetKind

Tipo di set di dati

Nome	Tipo	Descrizione
AudioAndScript	string
AudioOnly	string
LongAudio	string

Error

L'errore di primo livello segue le linee guida per l'API REST di Microsoft Azure disponibili in https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Contiene un errore di primo livello con codice di errore, messaggio, dettagli, destinazione e un errore interno con dettagli più descrittivi.

Nome	Tipo	Descrizione
code	ErrorCode	Codice di errore di primo livello
details	Error[]	Dettagli aggiuntivi di supporto relativi all'errore e/o ai criteri previsti.
innererror	InnerError	L'errore interno segue le linee guida dell'API REST di Microsoft Azure disponibili in https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Contiene il codice di errore delle proprietà necessarie, la destinazione del messaggio e le proprietà facoltative, l'errore interno(può essere annidato).
message	string	Messaggio di errore di primo livello.
target	string	Indica l'origine dell'errore. Ad esempio, sarebbe "model" o "model id" in caso di modello non valido.

ErrorCode

Codice di errore di primo livello

Nome	Tipo	Descrizione
BadArgument	string
BadRequest	string
Forbidden	string
InternalServerError	string
NotFound	string
ServiceUnavailable	string
TooManyRequests	string
Unauthorized	string
UnsupportedMediaType	string

ErrorResponse

La risposta agli errori segue le linee guida per l'API REST di Microsoft Azure disponibili in https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Nome	Tipo	Descrizione
error	Error	L'errore di primo livello segue le linee guida per l'API REST di Microsoft Azure disponibili in https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Contiene un errore di primo livello con codice di errore, messaggio, dettagli, destinazione e un errore interno con dettagli più descrittivi.

InnerError

L'errore interno segue le linee guida dell'API REST di Microsoft Azure disponibili in https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Contiene il codice di errore delle proprietà necessarie, la destinazione del messaggio e le proprietà facoltative, l'errore interno(può essere annidato).

Nome	Tipo	Descrizione
code	string	Codice di errore dettagliato per facilitare la diagnostica.
innererror	InnerError	L'errore interno segue le linee guida dell'API REST di Microsoft Azure disponibili in https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Contiene il codice di errore delle proprietà necessarie, la destinazione del messaggio e le proprietà facoltative, l'errore interno(può essere annidato).
message	string	Messaggio di errore dettagliato.
target	string	Indica l'origine dell'errore. Ad esempio, sarebbe "model" o "model id" in caso di modello non valido.

Condividi tramite

Training Sets - Upload Data

Parametri dell'URI

Intestazione della richiesta

Corpo della richiesta

Risposte

Sicurezza

Ocp-Apim-Subscription-Key

Esempio

Upload data to a training set

Esempio di richiesta

Risposta di esempio

Definizioni

AzureBlobContentSource

Dataset

DatasetKind

Error

ErrorCode

ErrorResponse

InnerError

Risorse aggiuntive