Training Sets - Create

Szolgáltatás:: Azure AI Services

API-verzió:: 2026-01-01

Új edzéskészletet hoz létre.

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

URI-paraméterek

Név	In	Kötelező	Típus	Description
endpoint	path	True	string (uri)	Támogatott Cognitive Services-végpontok (protokoll és állomásnév, például: 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]$	Az erőforrás azonosítója.
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.

Kérelem törzse

Név	Kötelező	Típus	Description
locale	True	string	A képzési adathalmaz helyszíne. A helyszíni kód a BCP-47-et követi. A szöveg-beszéd helyi listát itt https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=ttstalálod.
projectId	True	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Erőforrás-azonosító
description		string	Képzési készlet leírása
displayName		string minLength: 1	Képzési készlet neve
properties		TrainingSetProperties	A tanítási halmaz tulajdonságai
status		Status	Egy erőforrás állapota.
voiceKind		VoiceKind	Hangos

Válaszok

Név	Típus	Description
201 Created	TrainingSet	A kérés sikeres volt, és ennek eredményeként új erőforrás jött létre.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Váratlan hibaválasz. Fejlécek x-ms-error-code: string

Név

Típus

Description

201 Created

TrainingSet

A kérés sikeres volt, és ennek eredményeként új erőforrás jött létre.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Váratlan hibaválasz.

Fejlécek

x-ms-error-code: string

Biztonság

Ocp-Apim-Subscription-Key

Típus: apiKey
In: header

OAuth2Auth

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Név	Description
https://cognitiveservices.azure.com/.default

Példák

Create a training set

Mintakérelem

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

Mintaválasz

Állapotkód:: 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"
}

Definíciók

Név	Description
Azure.Core.Foundations.Error	A hibaobjektum.
Azure.Core.Foundations.ErrorResponse	Hibaadatokat tartalmazó válasz.
Azure.Core.Foundations.InnerError	Egy objektum, amely részletesebb információkat tartalmaz a hibáról. A Azure REST API irányelvek szerint – https://aka.ms/AzureRestApiGuidelines#handling-errors.
Status	Egy erőforrás állapota.
TrainingSet	Betanítási csoport
TrainingSetProperties	A tanítási halmaz tulajdonságai
VoiceKind	Hangos

Azure.Core.Foundations.Error

Tárgy

A hibaobjektum.

Név	Típus	Description
code	string	A kiszolgáló által definiált hibakódok egyike.
details	Azure.Core.Foundations.Error[]	A jelentett hibához vezető konkrét hibák részleteinek tömbje.
innererror	Azure.Core.Foundations.InnerError	Egy objektum, amely az aktuális objektumnál pontosabb információt tartalmaz a hibáról.
message	string	A hiba ember által olvasható ábrázolása.
target	string	A hiba célja.

Azure.Core.Foundations.ErrorResponse

Tárgy

Hibaadatokat tartalmazó válasz.

Név	Típus	Description
error	Azure.Core.Foundations.Error	A hibaobjektum.

Azure.Core.Foundations.InnerError

Tárgy

Egy objektum, amely részletesebb információkat tartalmaz a hibáról. A Azure REST API irányelvek szerint – https://aka.ms/AzureRestApiGuidelines#handling-errors.

Név	Típus	Description
code	string	A kiszolgáló által definiált hibakódok egyike.
innererror	Azure.Core.Foundations.InnerError	Belső hiba.

Status

Felsorolás

Egy erőforrás állapota.

Érték	Description
NotStarted	Még nem kezdődött el
Running	Futás közben
Succeeded	Sikerült
Failed	Meghiúsult
Disabling	Letiltása
Disabled	Disabled

TrainingSet

Tárgy

Betanítási csoport

Név	Típus	Description
createdDateTime	string (date-time)	Az objektum létrehozásakor megadott időbélyeg. Az időbélyeg ISO 8601 dátum- és időformátumként van kódolva ("YYYY-MM-DDThh:mm:ssZ", lásd https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
description	string	Képzési készlet leírása
displayName	string minLength: 1	Képzési készlet neve
id	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Erőforrás-azonosító
lastActionDateTime	string (date-time)	Az aktuális állapot megadásának időbélyege. Az időbélyeg ISO 8601 dátum- és időformátumként van kódolva ("YYYY-MM-DDThh:mm:ssZ", lásd https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
locale	string	A képzési adathalmaz helyszíne. A helyszíni kód a BCP-47-et követi. A szöveg-beszéd helyi listát itt https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=ttstalálod.
projectId	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Erőforrás-azonosító
properties	TrainingSetProperties	A tanítási halmaz tulajdonságai
status	Status	Egy erőforrás állapota.
voiceKind	VoiceKind	Hangos

TrainingSetProperties

Tárgy

A tanítási halmaz tulajdonságai

Név	Típus	Description
durationInSeconds	number (double)	A hang teljes időtartama másodpercekben ebben a képzési készletben
isContextual	boolean	Jelzi, hogy a képzési halmaz kontextuális adatokból áll-e
utteranceCount	integer (int32)	Kimondásszám ebben a képzési készletben

VoiceKind

Felsorolás

Hangos

Érték	Description
Male	Férfi
Female	Nő