Training Sets - Create

Service:

Azure AI Services

API Version:

2023-12-01-preview

Skapar en ny träningsuppsättning.

PUT {endpoint}/customvoice/trainingsets/{id}?api-version=2023-12-01-preview

URI-parametrar

Name	I	Obligatorisk	Typ	Description
endpoint	path	True	string	Cognitive Services-slutpunkter som stöds (protokoll och värdnamn, till exempel: https://eastus.api.cognitive.microsoft.com).
id	path	True	string	Resursens ID. Regex pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$
api-version	query	True	string	Den API-version som ska användas för den här åtgärden.

Begärandehuvud

Name	Obligatorisk	Typ	Description
Ocp-Apim-Subscription-Key	True	string	Ange din Speech-resursnyckel här.

Begärandetext

Name	Obligatorisk	Typ	Description
locale	True	string	Språkvarianten för träningsdatauppsättningen. Språkkod följer BCP-47. Du hittar listan med språkvarianter för text till tal här https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=tts.
projectId	True	string	Resurs-ID
description		string	Beskrivning av träningsuppsättning
displayName		string	Namn på träningsuppsättning
id		string	Resurs-ID
status		Status	Status för en resurs.
voiceKind		VoiceKind	Rösttyp

Svar

Name	Typ	Description
201 Created	TrainingSet	Skapad
Other Status Codes	ErrorResponse	Ett fel inträffade.

Säkerhet

Ocp-Apim-Subscription-Key

Ange din Speech-resursnyckel här.

Type: apiKey
In: header

Exempel

Create a training set

Sample Request

HTTP

PUT {endpoint}/customvoice/trainingsets/Jessica-300?api-version=2023-12-01-preview


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

Sample Response

Status code:

201

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

Definitioner

Name	Description
Error	Toppnivåfel följer Riktlinjerna för Microsoft Azure REST API som finns på https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Detta innehåller ett fel på den översta nivån med felkod, meddelande, information, mål och ett inre fel med mer beskrivande information.
ErrorCode	Felkod på den översta nivån
ErrorResponse	Felsvaret följer riktlinjerna för Microsoft Azure REST API som finns på https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
InnerError	Inre fel följer Riktlinjerna för Microsoft Azure REST API som finns på https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Detta innehåller felkod för obligatoriska egenskaper, meddelande och valfritt egenskapsmål, inre fel (detta kan kapslas).
Status	Status för en resurs.
TrainingSet	Träningsuppsättning
TrainingSetProperties	Egenskaper för träningsuppsättning
VoiceKind	Rösttyp

Error

Toppnivåfel följer Riktlinjerna för Microsoft Azure REST API som finns på https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Detta innehåller ett fel på den översta nivån med felkod, meddelande, information, mål och ett inre fel med mer beskrivande information.

Name	Typ	Description
code	ErrorCode	Felkod på den översta nivån
details	Error[]	Ytterligare stödjande information om fel- och/eller förväntade principer.
innererror	InnerError	Inre fel följer Riktlinjerna för Microsoft Azure REST API som finns på https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Detta innehåller felkod för obligatoriska egenskaper, meddelande och valfritt egenskapsmål, inre fel (detta kan kapslas).
message	string	Felmeddelande på den översta nivån.
target	string	Källan till felet. Det skulle till exempel vara "modell" eller "modell-ID" om modellen är ogiltig.

ErrorCode

Felkod på den översta nivån

Name	Typ	Description
BadArgument	string
BadRequest	string
Forbidden	string
InternalServerError	string
NotFound	string
ServiceUnavailable	string
TooManyRequests	string
Unauthorized	string
UnsupportedMediaType	string

ErrorResponse

Felsvaret följer riktlinjerna för Microsoft Azure REST API som finns på https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Name	Typ	Description
error	Error	Toppnivåfel följer Riktlinjerna för Microsoft Azure REST API som finns på https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Detta innehåller ett fel på den översta nivån med felkod, meddelande, information, mål och ett inre fel med mer beskrivande information.

InnerError

Inre fel följer Riktlinjerna för Microsoft Azure REST API som finns på https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Detta innehåller felkod för obligatoriska egenskaper, meddelande och valfritt egenskapsmål, inre fel (detta kan kapslas).

Name	Typ	Description
code	string	Detaljerad felkod för att hjälpa till med diagnostiken.
innererror	InnerError	Inre fel följer Riktlinjerna för Microsoft Azure REST API som finns på https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Detta innehåller felkod för obligatoriska egenskaper, meddelande och valfritt egenskapsmål, inre fel (detta kan kapslas).
message	string	Detaljerat felmeddelande.
target	string	Källan till felet. Det skulle till exempel vara "modell" eller "modell-ID" om modellen är ogiltig.

Status

Status för en resurs.

Name	Typ	Description
Disabled	string
Disabling	string
Failed	string
NotStarted	string
Running	string
Succeeded	string

TrainingSet

Träningsuppsättning

Name	Typ	Description
createdDateTime	string	Tidsstämpeln när objektet skapades. Tidsstämpeln kodas som datum- och tidsformatet ISO 8601 ("ÅÅÅÅ-MM-DDThh:mm:ssZ", se https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
description	string	Beskrivning av träningsuppsättning
displayName	string	Namn på träningsuppsättning
id	string	Resurs-ID
lastActionDateTime	string	Tidsstämpeln när den aktuella statusen angavs. Tidsstämpeln kodas som datum- och tidsformatet ISO 8601 ("ÅÅÅÅ-MM-DDThh:mm:ssZ", se https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
locale	string	Språkvarianten för träningsdatauppsättningen. Språkkod följer BCP-47. Du hittar listan med språkvarianter för text till tal här https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=tts.
projectId	string	Resurs-ID
properties	TrainingSetProperties	Egenskaper för träningsuppsättning
status	Status	Status för en resurs.
voiceKind	VoiceKind	Rösttyp

TrainingSetProperties

Egenskaper för träningsuppsättning

Name	Typ	Description
utteranceCount	integer	Antal yttranden i den här träningsuppsättningen

VoiceKind

Rösttyp

Name	Typ	Description
Female	string
Male	string