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 |
ID della risorsa. Criterio di espressione regolare: |
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 |
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: |
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 qui la chiave della risorsa Voce.
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 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. |
Error |
Codice di errore di primo livello |
Error |
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. |
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(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 |
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
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 |
Codice di errore di primo livello |
|
details |
Error[] |
Dettagli aggiuntivi 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(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 |
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 |
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. |