Training Sets - Create

Usługa:

Azure AI Services

Wersja interfejsu API:

2026-01-01

Tworzy nowy zestaw treningowy.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
endpoint	path	True	string (uri)	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 minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Identyfikator zasobu.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa	Wymagane	Typ	Opis
locale	True	string	Lokalizacja zbioru danych treningowych. Kod ustawień regionalnych jest zgodny z kodem BCP-47. Tekst na liście ustawień regionalnych mowy można znaleźć tutaj 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]$	Identyfikator zasobu
description		string	Opis zbioru treningowego
displayName		string minLength: 1	Nazwa zbioru treningowego
properties		TrainingSetProperties	Własności zbioru treningowego
status		Status	Status zasobu.
voiceKind		VoiceKind	Rodzaj głosu

Odpowiedzi

Nazwa	Typ	Opis
201 Created	TrainingSet	Żądanie zakończyło się pomyślnie i w rezultacie został utworzony nowy zasób.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Nieoczekiwana odpowiedź na błąd. Nagłówki x-ms-error-code: string

Zabezpieczenia

Ocp-Apim-Subscription-Key

Typ: apiKey
W: header

OAuth2Auth

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
https://cognitiveservices.azure.com/.default

Przykłady

Create a training set

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:

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

Definicje

Nazwa	Opis
Azure.Core.Foundations.Error	Obiekt błędu.
Azure.Core.Foundations.ErrorResponse	Odpowiedź zawierająca szczegóły błędu.
Azure.Core.Foundations.InnerError	Obiekt zawierający bardziej szczegółowe informacje o błędzie. Zgodnie z Azure wytycznymi API REST - https://aka.ms/AzureRestApiGuidelines#handling-errors.
Status	Status zasobu.
TrainingSet	Zestaw szkoleniowy
TrainingSetProperties	Własności zbioru treningowego
VoiceKind	Rodzaj głosu

Azure.Core.Foundations.Error

Objekt

Obiekt błędu.

Nazwa	Typ	Opis
code	string	Jeden z zdefiniowanych przez serwer zestaw kodów błędów.
details	Azure.Core.Foundations.Error[]	Tablica szczegółów dotyczących określonych błędów, które doprowadziły do tego zgłoszonego błędu.
innererror	Azure.Core.Foundations.InnerError	Obiekt zawierający bardziej szczegółowe informacje niż bieżący obiekt o błędzie.
message	string	Czytelna dla człowieka reprezentacja błędu.
target	string	Element docelowy błędu.

Azure.Core.Foundations.ErrorResponse

Objekt

Odpowiedź zawierająca szczegóły błędu.

Nazwa	Typ	Opis
error	Azure.Core.Foundations.Error	Obiekt błędu.

Azure.Core.Foundations.InnerError

Objekt

Obiekt zawierający bardziej szczegółowe informacje o błędzie. Zgodnie z Azure wytycznymi API REST - https://aka.ms/AzureRestApiGuidelines#handling-errors.

Nazwa	Typ	Opis
code	string	Jeden z zdefiniowanych przez serwer zestaw kodów błędów.
innererror	Azure.Core.Foundations.InnerError	Błąd wewnętrzny.

Status

Wyliczenie

Status zasobu.

Wartość	Opis
NotStarted	Nierozpoczęty
Running	Bieganie
Succeeded	Powodzenie
Failed	Niepowodzenie
Disabling	Wyłączanie
Disabled	Wyłączony

TrainingSet

Objekt

Zestaw szkoleniowy

Nazwa	Typ	Opis
createdDateTime	string (date-time)	Znacznik czasu utworzenia obiektu. Znacznik czasu jest kodowany jako format daty i godziny ISO 8601 ("YYYY-MM-DDThh:mm:ssZ", patrz ).https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations
description	string	Opis zbioru treningowego
displayName	string minLength: 1	Nazwa zbioru treningowego
id	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Identyfikator zasobu
lastActionDateTime	string (date-time)	Znacznik czasu wpisania aktualnego statusu. Znacznik czasu jest kodowany jako format daty i godziny ISO 8601 ("YYYY-MM-DDThh:mm:ssZ", patrz ).https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations
locale	string	Lokalizacja zbioru danych treningowych. Kod ustawień regionalnych jest zgodny z kodem BCP-47. Tekst na liście ustawień regionalnych mowy można znaleźć tutaj 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]$	Identyfikator zasobu
properties	TrainingSetProperties	Własności zbioru treningowego
status	Status	Status zasobu.
voiceKind	VoiceKind	Rodzaj głosu

TrainingSetProperties

Objekt

Własności zbioru treningowego

Nazwa	Typ	Opis
durationInSeconds	number (double)	Całkowity czas trwania dźwięku w sekundach w tym zestawie treningowym
isContextual	boolean	Wskazuje, czy zbiór treningowy składa się z danych kontekstowych
utteranceCount	integer (int32)	Liczba wypowiedzi w tym zbiorze treningowym

VoiceKind

Wyliczenie

Rodzaj głosu

Wartość	Opis
Male	Mężczyzna
Female	Kobieta