Training Sets - Create

Servizio:: Azure AI Services

Versione API:: 2026-01-01

Crea un nuovo set di allenamento.

PUT {endpoint}/customvoice/trainingsets/{id}?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.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
locale	True	string	La località del dataset di addestramento. Il codice locale segue BCP-47. Puoi trovare qui la lista https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=ttsdelle località di sintesi vocali.
projectId	True	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	ID risorsa
description		string	Descrizione del set di addestramento
displayName		string minLength: 1	Nome del set di addestramento
properties		TrainingSetProperties	Proprietà del set di addestramento
status		Status	Stato di una risorsa.
voiceKind		VoiceKind	Voce

Risposte

Nome	Tipo	Descrizione
201 Created	TrainingSet	La richiesta ha avuto esito positivo e di conseguenza è stata creata una nuova risorsa.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Risposta di errore imprevista. Intestazioni x-ms-error-code: string

Nome

Tipo

Descrizione

201 Created

TrainingSet

La richiesta ha avuto esito positivo e di conseguenza è stata creata una nuova risorsa.

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

Create a training set

Esempio di richiesta

HTTP

PUT {endpoint}/customvoice/trainingsets/Jessica-300?api-version=2026-01-01

{
  "description": "300 sentences Jessica data in general style.",
  "locale": "en-US",
  "projectId": "Jessica",
  "voiceKind": "Female"
}

Risposta di esempio

Codice di stato:: 201

{
  "description": "300 sentences Jessica data in general style.",
  "createdDateTime": "2023-04-01T05:30:00.000Z",
  "id": "Jessica-300",
  "lastActionDateTime": "2023-04-02T10:15:30.000Z",
  "locale": "en-US",
  "projectId": "Jessica",
  "status": "Succeeded",
  "voiceKind": "Female"
}

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.
Status	Stato di una risorsa.
TrainingSet	Set di addestramento
TrainingSetProperties	Proprietà del set di addestramento
VoiceKind	Voce

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.

Status

Enumerazione

Stato di una risorsa.

Valore	Descrizione
NotStarted	Non Avviato
Running	In esecuzione
Succeeded	Succeeded
Failed	Non riuscito
Disabling	Disattivazione
Disabled	Disattivato

TrainingSet

Oggetto

Set di addestramento

Nome	Tipo	Descrizione
createdDateTime	string (date-time)	Il timestamp in cui l'oggetto è stato creato. Il timestamp è codificato come data e ora ISO 8601 ("YYYY-MM-DDThh:mm:ssZ", vedi https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
description	string	Descrizione del set di addestramento
displayName	string minLength: 1	Nome del set di addestramento
id	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	ID risorsa
lastActionDateTime	string (date-time)	Il timestamp in cui è stato inserito lo stato attuale. Il timestamp è codificato come data e ora ISO 8601 ("YYYY-MM-DDThh:mm:ssZ", vedi https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
locale	string	La località del dataset di addestramento. Il codice locale segue BCP-47. Puoi trovare qui la lista https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=ttsdelle località di sintesi vocali.
projectId	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	ID risorsa
properties	TrainingSetProperties	Proprietà del set di addestramento
status	Status	Stato di una risorsa.
voiceKind	VoiceKind	Voce

TrainingSetProperties

Oggetto

Proprietà del set di addestramento

Nome	Tipo	Descrizione
durationInSeconds	number (double)	Durata totale dell'audio in secondi in questo set di addestramento
isContextual	boolean	Indica se il set di addestramento è composto da dati contestuali
utteranceCount	integer (int32)	Conteggio delle enunciazioni in questo set di addestramento

VoiceKind

Enumerazione

Voce

Valore	Descrizione
Male	Maschio
Female	Femmina