Training Sets - Create

Usługa:

Azure AI Services

Wersja interfejsu API:

2024-02-01-preview

Tworzy nowy zestaw trenowania.

PUT {endpoint}/customvoice/trainingsets/{id}?api-version=2024-02-01-preview

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
endpoint	path	True	string	Obsługiwane punkty końcowe usług Cognitive Services (protokół i nazwa hosta, na przykład: https://eastus.api.cognitive.microsoft.com).
id	path	True	string	Identyfikator zasobu. Wzorzec wyrażenia regularnego: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$
api-version	query	True	string	Wersja interfejsu API do użycia dla tej operacji.

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
Ocp-Apim-Subscription-Key	True	string	Tutaj podaj klucz zasobu usługi Mowa.

Treść żądania

Nazwa	Wymagane	Typ	Opis
locale	True	string	Ustawienia regionalne zestawu danych trenowania. Kod ustawień regionalnych jest zgodny z kodem BCP-47. Tekst do ustawień regionalnych mowy można znaleźć tutaj https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=tts.
projectId	True	string	Identyfikator zasobu
description		string	Opis zestawu szkoleniowego
displayName		string	Nazwa zestawu trenowania
id		string	Identyfikator zasobu
status		Status	Stan zasobu.
voiceKind		VoiceKind	Rodzaj głosu

Odpowiedzi

Nazwa	Typ	Opis
201 Created	TrainingSet	Utworzone
Other Status Codes	ErrorResponse	Wystąpił błąd. Nagłówki x-ms-error-code: string

Zabezpieczenia

Ocp-Apim-Subscription-Key

Tutaj podaj klucz zasobu usługi Mowa.

Typ: apiKey
W: header

Przykłady

Create a training set

Przykładowe żądanie

HTTP

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


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

Przykładowa odpowiedź

Kod stanu:

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

Definicje

Nazwa	Opis
Error	Błąd najwyższego poziomu jest zgodny z wytycznymi interfejsu API REST platformy Microsoft Azure dostępnymi pod adresem https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Zawiera to błąd najwyższego poziomu z kodem błędu, komunikatem, szczegółami, elementem docelowym i wewnętrznym błędem z bardziej opisowymi szczegółami.
ErrorCode	Kod błędu najwyższego poziomu
ErrorResponse	Odpowiedź na błąd jest zgodna z wytycznymi interfejsu API REST platformy Microsoft Azure, które są dostępne pod adresem https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
InnerError	Błąd wewnętrzny jest zgodny z wytycznymi interfejsu API REST platformy Microsoft Azure dostępnymi pod adresem https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Zawiera on wymagany kod błędu właściwości, komunikat i obiekt docelowy właściwości opcjonalnych, błąd wewnętrzny (można go zagnieżdżać).
Status	Stan zasobu.
TrainingSet	Zestaw treningowy
TrainingSetProperties	Właściwości zestawu trenowania
VoiceKind	Rodzaj głosu

Error

Błąd najwyższego poziomu jest zgodny z wytycznymi interfejsu API REST platformy Microsoft Azure dostępnymi pod adresem https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Zawiera to błąd najwyższego poziomu z kodem błędu, komunikatem, szczegółami, elementem docelowym i wewnętrznym błędem z bardziej opisowymi szczegółami.

Nazwa	Typ	Opis
code	ErrorCode	Kod błędu najwyższego poziomu
details	Error[]	Dodatkowe szczegóły pomocnicze dotyczące błędów i/lub oczekiwanych zasad.
innererror	InnerError	Błąd wewnętrzny jest zgodny z wytycznymi interfejsu API REST platformy Microsoft Azure dostępnymi pod adresem https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Zawiera on wymagany kod błędu właściwości, komunikat i obiekt docelowy właściwości opcjonalnych, błąd wewnętrzny (można go zagnieżdżać).
message	string	Komunikat o błędzie najwyższego poziomu.
target	string	Źródło błędu. Na przykład będzie to "model" lub "identyfikator modelu" w przypadku nieprawidłowego modelu.

ErrorCode

Kod błędu najwyższego poziomu

Nazwa	Typ	Opis
BadArgument	string
BadRequest	string
Forbidden	string
InternalServerError	string
NotFound	string
ServiceUnavailable	string
TooManyRequests	string
Unauthorized	string
UnsupportedMediaType	string

ErrorResponse

Odpowiedź na błąd jest zgodna z wytycznymi interfejsu API REST platformy Microsoft Azure, które są dostępne pod adresem https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Nazwa	Typ	Opis
error	Error	Błąd najwyższego poziomu jest zgodny z wytycznymi interfejsu API REST platformy Microsoft Azure dostępnymi pod adresem https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Zawiera to błąd najwyższego poziomu z kodem błędu, komunikatem, szczegółami, elementem docelowym i wewnętrznym błędem z bardziej opisowymi szczegółami.

InnerError

Błąd wewnętrzny jest zgodny z wytycznymi interfejsu API REST platformy Microsoft Azure dostępnymi pod adresem https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Zawiera on wymagany kod błędu właściwości, komunikat i obiekt docelowy właściwości opcjonalnych, błąd wewnętrzny (można go zagnieżdżać).

Nazwa	Typ	Opis
code	string	Szczegółowy kod błędu pomocny w diagnostyce.
innererror	InnerError	Błąd wewnętrzny jest zgodny z wytycznymi interfejsu API REST platformy Microsoft Azure dostępnymi pod adresem https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Zawiera on wymagany kod błędu właściwości, komunikat i obiekt docelowy właściwości opcjonalnych, błąd wewnętrzny (można go zagnieżdżać).
message	string	Szczegółowy komunikat o błędzie.
target	string	Źródło błędu. Na przykład będzie to "model" lub "identyfikator modelu" w przypadku nieprawidłowego modelu.

Status

Stan zasobu.

Nazwa	Typ	Opis
Disabled	string
Disabling	string
Failed	string
NotStarted	string
Running	string
Succeeded	string

TrainingSet

Zestaw treningowy

Nazwa	Typ	Opis
createdDateTime	string	Sygnatura czasowa utworzenia obiektu. Znacznik czasu jest zakodowany jako format daty i godziny ISO 8601 ("RRRR-MM-DDThh:mm:ssZ", zobacz https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
description	string	Opis zestawu szkoleniowego
displayName	string	Nazwa zestawu trenowania
id	string	Identyfikator zasobu
lastActionDateTime	string	Sygnatura czasowa po wprowadzeniu bieżącego stanu. Znacznik czasu jest zakodowany jako format daty i godziny ISO 8601 ("RRRR-MM-DDThh:mm:ssZ", zobacz https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
locale	string	Ustawienia regionalne zestawu danych trenowania. Kod ustawień regionalnych jest zgodny z kodem BCP-47. Tekst do ustawień regionalnych mowy można znaleźć tutaj https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=tts.
projectId	string	Identyfikator zasobu
properties	TrainingSetProperties	Właściwości zestawu trenowania
status	Status	Stan zasobu.
voiceKind	VoiceKind	Rodzaj głosu

TrainingSetProperties

Właściwości zestawu trenowania

Nazwa	Typ	Opis
utteranceCount	integer	Liczba wypowiedzi w tym zestawie trenowania

VoiceKind

Rodzaj głosu

Nazwa	Typ	Opis
Female	string
Male	string