Training Sets - Create

Служба:: Azure AI Services

Версия API:: 2026-01-01

Создаёт новый тренировочный набор.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
endpoint	path	True	string (uri)	Поддерживаемые конечные точки Cognitive Services (протокол и имя узла, например: 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]$	Идентификатор ресурса.
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.

Текст запроса

Имя	Обязательно	Тип	Описание
locale	True	string	Местоположение учебного набора данных. Код локации соответствует BCP-47. Вы можете найти список местоположения для превращения текста в речь здесь 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]$	Идентификатор ресурса
description		string	Описание учебного комплекта
displayName		string minLength: 1	Название учебного комплекта
properties		TrainingSetProperties	Свойства обучающих наборов
status		Status	Статус ресурса.
voiceKind		VoiceKind	Голос

Ответы

Имя	Тип	Описание
201 Created	TrainingSet	Запрос успешно выполнен, и в результате был создан новый ресурс.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Непредвиденное сообщение об ошибке. Заголовки x-ms-error-code: string

Имя

Тип

Описание

201 Created

TrainingSet

Запрос успешно выполнен, и в результате был создан новый ресурс.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Непредвиденное сообщение об ошибке.

Заголовки

x-ms-error-code: string

Безопасность

Ocp-Apim-Subscription-Key

Тип: apiKey
В: header

OAuth2Auth

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
https://cognitiveservices.azure.com/.default

Примеры

Create a training set

Образец запроса

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

Пример ответа

Код состояния:: 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"
}

Определения

Имя	Описание
Azure.Core.Foundations.Error	Объект ошибки.
Azure.Core.Foundations.ErrorResponse	Ответ, содержащий сведения об ошибке.
Azure.Core.Foundations.InnerError	Объект, содержащий более конкретные сведения об ошибке. Согласно Azure рекомендациям REST API — https://aka.ms/AzureRestApiGuidelines#handling-errors.
Status	Статус ресурса.
TrainingSet	Тренировочный набор
TrainingSetProperties	Свойства обучающих наборов
VoiceKind	Голос

Azure.Core.Foundations.Error

Объект

Объект ошибки.

Имя	Тип	Описание
code	string	Один из определяемых сервером кодов ошибок.
details	Azure.Core.Foundations.Error[]	Массив сведений об определенных ошибках, которые привели к этой сообщаемой ошибке.
innererror	Azure.Core.Foundations.InnerError	Объект, содержащий более конкретные сведения, чем текущий объект об ошибке.
message	string	Читаемое пользователем представление ошибки.
target	string	Целевой объект ошибки.

Azure.Core.Foundations.ErrorResponse

Объект

Ответ, содержащий сведения об ошибке.

Имя	Тип	Описание
error	Azure.Core.Foundations.Error	Объект ошибки.

Azure.Core.Foundations.InnerError

Объект

Объект, содержащий более конкретные сведения об ошибке. Согласно Azure рекомендациям REST API — https://aka.ms/AzureRestApiGuidelines#handling-errors.

Имя	Тип	Описание
code	string	Один из определяемых сервером кодов ошибок.
innererror	Azure.Core.Foundations.InnerError	Внутренняя ошибка.

Status

Перечисление

Статус ресурса.

Значение	Описание
NotStarted	Не начато
Running	Бег
Succeeded	Succeeded
Failed	Неудача
Disabling	Отключение
Disabled	Disabled

TrainingSet

Объект

Тренировочный набор

Имя	Тип	Описание
createdDateTime	string (date-time)	Временная метка, когда объект был создан. Метка времени кодируется в формате даты и времени ISO 8601 («YYYY-MM-DDThh:mm:ssZ», см. https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
description	string	Описание учебного комплекта
displayName	string minLength: 1	Название учебного комплекта
id	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Идентификатор ресурса
lastActionDateTime	string (date-time)	Отметка времени ввода текущего статуса. Метка времени кодируется в формате даты и времени ISO 8601 («YYYY-MM-DDThh:mm:ssZ», см. https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
locale	string	Местоположение учебного набора данных. Код локации соответствует BCP-47. Вы можете найти список местоположения для превращения текста в речь здесь 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]$	Идентификатор ресурса
properties	TrainingSetProperties	Свойства обучающих наборов
status	Status	Статус ресурса.
voiceKind	VoiceKind	Голос

TrainingSetProperties

Объект

Свойства обучающих наборов

Имя	Тип	Описание
durationInSeconds	number (double)	Общая продолжительность аудио в секундах в этом тренировочном наборе
isContextual	boolean	Указывает, состоит ли обучающий набор из контекстных данных
utteranceCount	integer (int32)	Количество высказываний в этом наборе тренировок

VoiceKind

Перечисление

Голос

Значение	Описание
Male	Муж.
Female	Женщина