Training Sets - Create

Dienst:

Azure AI Services

API-Version:

2026-01-01

Erstellt ein neues Trainingsset.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
endpoint	path	True	string (uri)	Unterstützte Cognitive Services-Endpunkte (Protokoll und Hostname, z. B. 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]$	Die ID der Ressource.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
locale	True	string	Der Ort des Trainingsdatensatzes. Der Standortcode folgt auf BCP-47. Die Text-to-Speech-Standortliste finden Sie hier https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=tts.
projectId	True	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Ressourcen-ID
description		string	Beschreibung des Trainingssatzes
displayName		string minLength: 1	Name des Trainingssets
properties		TrainingSetProperties	Eigenschaften des Trainingssatzes
status		Status	Status einer Ressource.
voiceKind		VoiceKind	Stimmtyp

Antworten

Name	Typ	Beschreibung
201 Created	TrainingSet	Die Anforderung ist erfolgreich und eine neue Ressource wurde als Ergebnis erstellt.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Unerwartete Fehlerantwort. Header x-ms-error-code: string

Sicherheit

Ocp-Apim-Subscription-Key

Typ: apiKey
In: header

OAuth2Auth

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
https://cognitiveservices.azure.com/.default

Beispiele

Create a training set

Beispielanforderung

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"
}

Beispiel für eine Antwort

Statuscode:

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"
}

Definitionen

Name	Beschreibung
Azure.Core.Foundations.Error	Das Fehlerobjekt.
Azure.Core.Foundations.ErrorResponse	Eine Antwort, die Fehlerdetails enthält.
Azure.Core.Foundations.InnerError	Ein Objekt, das spezifischere Informationen zum Fehler enthält. Laut Azure REST API-Richtlinien – https://aka.ms/AzureRestApiGuidelines#handling-errors.
Status	Status einer Ressource.
TrainingSet	Trainingssatz
TrainingSetProperties	Eigenschaften des Trainingssatzes
VoiceKind	Stimmtyp

Azure.Core.Foundations.Error

Objekt

Das Fehlerobjekt.

Name	Typ	Beschreibung
code	string	Eine serverdefinierte Gruppe von Fehlercodes.
details	Azure.Core.Foundations.Error[]	Ein Array von Details zu bestimmten Fehlern, die zu diesem gemeldeten Fehler geführt haben.
innererror	Azure.Core.Foundations.InnerError	Ein Objekt, das spezifischere Informationen enthält als das aktuelle Objekt über den Fehler.
message	string	Eine lesbare Darstellung des Fehlers.
target	string	Das Ziel des Fehlers.

Azure.Core.Foundations.ErrorResponse

Objekt

Eine Antwort, die Fehlerdetails enthält.

Name	Typ	Beschreibung
error	Azure.Core.Foundations.Error	Das Fehlerobjekt.

Azure.Core.Foundations.InnerError

Objekt

Ein Objekt, das spezifischere Informationen zum Fehler enthält. Laut Azure REST API-Richtlinien – https://aka.ms/AzureRestApiGuidelines#handling-errors.

Name	Typ	Beschreibung
code	string	Eine serverdefinierte Gruppe von Fehlercodes.
innererror	Azure.Core.Foundations.InnerError	Innerer Fehler.

Status

Enumeration

Status einer Ressource.

Wert	Beschreibung
NotStarted	Nicht gestartet
Running	Laufen
Succeeded	Erfolgreich
Failed	gescheitert
Disabling	Deaktivieren
Disabled	Deaktiviert

TrainingSet

Objekt

Trainingssatz

Name	Typ	Beschreibung
createdDateTime	string (date-time)	Der Zeitstempel, zu dem das Objekt erstellt wurde. Der Zeitstempel wird als ISO 8601-Datums- und Uhrzeitformat codiert ("JJJJ-MM-DDThh:mm:ssZ", siehe https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
description	string	Beschreibung des Trainingssatzes
displayName	string minLength: 1	Name des Trainingssets
id	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Ressourcen-ID
lastActionDateTime	string (date-time)	Der Zeitstempel, zu dem der aktuelle Status eingegeben wurde. Der Zeitstempel wird als ISO 8601-Datums- und Uhrzeitformat codiert ("JJJJ-MM-DDThh:mm:ssZ", siehe https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
locale	string	Der Ort des Trainingsdatensatzes. Der Standortcode folgt auf BCP-47. Die Text-to-Speech-Standortliste finden Sie hier https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=tts.
projectId	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Ressourcen-ID
properties	TrainingSetProperties	Eigenschaften des Trainingssatzes
status	Status	Status einer Ressource.
voiceKind	VoiceKind	Stimmtyp

TrainingSetProperties

Objekt

Eigenschaften des Trainingssatzes

Name	Typ	Beschreibung
durationInSeconds	number (double)	Gesamtdauer des Audios in Sekunden in diesem Trainingsset
isContextual	boolean	Gibt an, ob der Trainingssatz aus kontextuellen Daten besteht
utteranceCount	integer (int32)	Anzahl der Äußerungen in diesem Trainingsset

VoiceKind

Enumeration

Stimmtyp

Wert	Beschreibung
Male	Männlich
Female	Weiblich