Training Sets - Upload Data

Servizio:: Azure AI Services

Versione API:: 2026-01-01

Carica i dati nel set di addestramento specificato.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
endpoint	path	True	string (uri)	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
Operation-Id		string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	ID del monitor di stato per l'operazione. Se l'intestazione Operation-Id corrisponde a un'operazione esistente e la richiesta non è identica a quella precedente, fallirà con una richiesta 400 Bad Request.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
audios	True	AzureBlobContentSource	Archiviazione BLOB di Azure content. Con gli esempi sottostanti, rappresenta i file `https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav`
kind	True	DatasetKind	Tipo di dataset
description		string	Descrizione opzionale di questo dataset.
displayName		string	Il nome di questo dataset.
processAs		DatasetProcessAs	Metodo di elaborazione del dataset. Se non specificato, verrà utilizzato il metodo di elaborazione predefinito.
scripts		AzureBlobContentSource	Archiviazione BLOB di Azure content. Con gli esempi sottostanti, rappresenta i file `https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav`

Risposte

Nome	Tipo	Descrizione
202 Accepted		La richiesta è stata accettata per l'elaborazione, ma l'elaborazione non è ancora stata completata. Intestazioni Operation-Id: string Operation-Location: string
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Risposta di errore imprevista. Intestazioni x-ms-error-code: string

Nome

Tipo

Descrizione

202 Accepted

La richiesta è stata accettata per l'elaborazione, ma l'elaborazione non è ancora stata completata.

Intestazioni

Operation-Id: string
Operation-Location: string

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Risposta di errore imprevista.

Intestazioni

x-ms-error-code: string

Sicurezza

Ocp-Apim-Subscription-Key

Tipo: apiKey
In: header

OAuth2Auth

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
https://cognitiveservices.azure.com/.default

Esempio

Upload data to a training set

Esempio di richiesta

HTTP

POST {endpoint}/customvoice/trainingsets/d6916a55-2cbc-4ed4-bd19-739e9a13b0ab:upload?api-version=2026-01-01


{
  "audios": {
    "containerUrl": "https://contoso.blob.core.windows.net/voicecontainer?mySasToken",
    "prefix": "jessica300/",
    "extensions": [
      ".wav"
    ]
  },
  "kind": "AudioAndScript",
  "processAs": "Segmented",
  "scripts": {
    "containerUrl": "https://contoso.blob.core.windows.net/voicecontainer?mySasToken",
    "prefix": "jessica300/",
    "extensions": [
      ".txt"
    ]
  }
}

Risposta di esempio

Codice di stato:: 202

Operation-Id: 284b7e37-f42d-4054-8fa9-08523c3de345
Operation-Location: https://eastus.api.cognitive.microsoft.com/customvoice/operations/284b7e37-f42d-4054-8fa9-08523c3de345?api-version=2026-01-01

Definizioni

Nome	Descrizione
Azure.Core.Foundations.Error	Oggetto error.
Azure.Core.Foundations.ErrorResponse	Risposta contenente i dettagli dell'errore.
Azure.Core.Foundations.InnerError	Oggetto contenente informazioni più specifiche sull'errore. Secondo le linee guida Azure REST API - https://aka.ms/AzureRestApiGuidelines#handling-errors.
AzureBlobContentSource	Archiviazione BLOB di Azure content. Con gli esempi sottostanti, rappresenta i file `https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav`
Dataset	Oggetto Dataset
DatasetKind	Tipo di dataset
DatasetProcessAs	Metodo di elaborazione del dataset. Se non specificato, verrà utilizzato il metodo di elaborazione predefinito.

Azure.Core.Foundations.Error

Oggetto

Oggetto error.

Nome	Tipo	Descrizione
code	string	Uno di un set definito dal server di codici di errore.
details	Azure.Core.Foundations.Error[]	Matrice di dettagli sugli errori specifici che hanno causato l'errore segnalato.
innererror	Azure.Core.Foundations.InnerError	Oggetto contenente informazioni più specifiche dell'oggetto corrente sull'errore.
message	string	Rappresentazione leggibile dell'errore.
target	string	Destinazione dell'errore.

Azure.Core.Foundations.ErrorResponse

Oggetto

Risposta contenente i dettagli dell'errore.

Nome	Tipo	Descrizione
error	Azure.Core.Foundations.Error	Oggetto error.

Azure.Core.Foundations.InnerError

Oggetto

Oggetto contenente informazioni più specifiche sull'errore. Secondo le linee guida Azure REST API - https://aka.ms/AzureRestApiGuidelines#handling-errors.

Nome	Tipo	Descrizione
code	string	Uno di un set definito dal server di codici di errore.
innererror	Azure.Core.Foundations.InnerError	Errore interno.

AzureBlobContentSource

Oggetto

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

Nome	Tipo	Descrizione
containerUrl	string (uri)	Archiviazione BLOB di Azure URL del container con SAS. Servono sia i permessi di lettura che di listaggio.
extensions	string[]	Estensioni dei nomi dei file.
prefix	string	Prefisso del nome del blob.

Dataset

Oggetto

Oggetto Dataset

Nome	Tipo	Descrizione
audios	AzureBlobContentSource	Archiviazione BLOB di Azure content. Con gli esempi sottostanti, rappresenta i file `https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav`
description	string	Descrizione opzionale di questo dataset.
displayName	string	Il nome di questo dataset.
kind	DatasetKind	Tipo di dataset
processAs	DatasetProcessAs	Metodo di elaborazione del dataset. Se non specificato, verrà utilizzato il metodo di elaborazione predefinito.
scripts	AzureBlobContentSource	Archiviazione BLOB di Azure content. Con gli esempi sottostanti, rappresenta i file `https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav`

DatasetKind

Enumerazione

Tipo di dataset

Valore	Descrizione
AudioAndScript	AudioeScript
LongAudio	LongAudio
AudioOnly	Solo audio

DatasetProcessAs

Enumerazione

Metodo di elaborazione del dataset. Se non specificato, verrà utilizzato il metodo di elaborazione predefinito.

Valore	Descrizione
Segmented	La modalità di elaborazione predefinita che funziona con tutte le lingue supportate.
Contextual	Una modalità potenziata che mantiene l'audio nel suo insieme per mantenere le informazioni contestuali per intonazioni più naturali.