Training Sets - Upload Data
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 |
---|---|---|---|---|
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 minLength: 3maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$ |
ID della risorsa. |
api-version
|
query | True |
string minLength: 1 |
Versione dell'API da usare per questa operazione. |
Intestazione della richiesta
Nome | Necessario | Tipo | Descrizione |
---|---|---|---|
Ocp-Apim-Subscription-Key | True |
string |
Specificare la chiave della risorsa Voce qui. |
Operation-Id |
string minLength: 3maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$ |
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 400 non valida. |
Corpo della richiesta
Nome | Necessario | Tipo | Descrizione |
---|---|---|---|
audios | True |
Contenuto di Archiviazione BLOB di Azure. Con gli esempi seguenti, rappresenta i file https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav |
|
kind | True |
Tipo di set di dati |
|
description |
string |
Descrizione facoltativa del set di dati. |
|
displayName |
string |
Nome del set di dati. |
|
scripts |
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
|
|
Other Status Codes |
Si è verificato un errore. Intestazioni x-ms-error-code: string |
Sicurezza
Ocp-Apim-Subscription-Key
Specificare la chiave della risorsa Voce qui.
Tipo:
apiKey
In:
header
Esempio
Upload data to a training set
Esempio di richiesta
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
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 |
---|---|
Azure |
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 |
Dataset |
Tipo di set di dati |
Error |
L'errore di primo livello 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 un errore di primo livello con codice di errore, messaggio, dettagli, destinazione e errore interno con dettagli più descrittivi. |
Error |
Codice di errore di primo livello |
Error |
La risposta di errore 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. |
Inner |
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 (che 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) |
URL del contenitore di Archiviazione BLOB di Azure con sas. Sono necessarie autorizzazioni di lettura ed elenco. |
extensions |
string[] |
Estensioni di file. |
prefix |
string |
Prefisso del nome BLOB. |
Dataset
Oggetto Dataset
Nome | Tipo | Descrizione |
---|---|---|
audios |
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 |
Tipo di set di dati |
|
scripts |
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
Valore | Descrizione |
---|---|
AudioAndScript | |
AudioOnly | |
LongAudio |
Error
L'errore di primo livello 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 un errore di primo livello con codice di errore, messaggio, dettagli, destinazione e errore interno con dettagli più descrittivi.
Nome | Tipo | Descrizione |
---|---|---|
code |
Codice di errore di primo livello |
|
details |
Error[] |
Ulteriori dettagli di supporto relativi all'errore e/o ai criteri previsti. |
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 (che può essere annidato). |
|
message |
string |
Messaggio di errore di primo livello. |
target |
string |
Origine dell'errore. Ad esempio, sarebbe "model" o "model id" in caso di modello non valido. |
ErrorCode
Codice di errore di primo livello
Valore | Descrizione |
---|---|
BadArgument | |
BadRequest | |
Forbidden | |
InternalServerError | |
NotFound | |
ServiceUnavailable | |
TooManyRequests | |
Unauthorized | |
UnsupportedMediaType |
ErrorResponse
La risposta di errore 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.
Nome | Tipo | Descrizione |
---|---|---|
error |
L'errore di primo livello 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 un errore di primo livello con codice di errore, messaggio, dettagli, destinazione e 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 (che può essere annidato).
Nome | Tipo | Descrizione |
---|---|---|
code |
string |
Codice di errore dettagliato per facilitare la diagnostica. |
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 (che può essere annidato). |
|
message |
string |
Messaggio di errore dettagliato. |
target |
string |
Origine dell'errore. Ad esempio, sarebbe "model" o "model id" in caso di modello non valido. |