Condividi tramite


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: 3
maxLength: 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: 3
maxLength: 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

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

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
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 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.

ErrorCode

Codice di errore di primo livello

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.

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).

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

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

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

ErrorCode

Codice di errore di primo livello

details

Error[]

Ulteriori dettagli 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 (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

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

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.