Models - Create

Ссылка

Служба:: Azure AI Services

Версия API:: 2024-02-01-preview

Создает новую голосовую модель.

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

Параметры URI

Имя В Обязательно Тип Описание

Имя	В	Обязательно	Тип	Описание
endpoint	path	True	string	Поддерживаемые конечные точки Cognitive Services (протокол и имя узла, например). https://eastus.api.cognitive.microsoft.com
id	path	True	string	Идентификатор ресурса. Шаблон регулярного выражения: `^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$`
api-version	query	True	string	Версия API, используемая для данной операции.

endpoint

path

True

string

Поддерживаемые конечные точки Cognitive Services (протокол и имя узла, например). https://eastus.api.cognitive.microsoft.com

path

True

string

Идентификатор ресурса.

Шаблон регулярного выражения: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$

api-version

query

True

string

Версия API, используемая для данной операции.

Заголовок запроса

Имя Обязательно Тип Описание

Ocp-Apim-Subscription-Key

True

Имя	Обязательно	Тип	Описание
Ocp-Apim-Subscription-Key	True	string	Укажите здесь ключ ресурса службы "Речь".
Operation-Id		string	Идентификатор монитора состояния для операции. Если заголовок Operation-Id соответствует существующей операции и запрос не идентичен предыдущему запросу, он завершится ошибкой с ошибкой 400 Bad Request. Шаблон регулярного выражения: `^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$`

string

Укажите здесь ключ ресурса службы "Речь".

Operation-Id

string

Идентификатор монитора состояния для операции. Если заголовок Operation-Id соответствует существующей операции и запрос не идентичен предыдущему запросу, он завершится ошибкой с ошибкой 400 Bad Request.

Шаблон регулярного выражения: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$

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

Имя	Обязательно	Тип	Описание
consentId	True	string	Идентификатор ресурса
projectId	True	string	Идентификатор ресурса
recipe	True	Recipe	Рецепт для построения модели. Разные рецепты имеют разные возможности.
trainingSetId	True	string	Идентификатор ресурса
description		string	Описание модели
id		string	Идентификатор ресурса
locale		string	Языковой стандарт этой модели. Код языкового стандарта следует за BCP-47. Список языковых стандартов для преобразования текста в речь можно найти здесь https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=tts.
properties		ModelProperties	Свойства модели
status		Status	Состояние ресурса.
voiceName		string	Название голоса

Ответы

Имя	Тип	Описание
201 Created	Model	Создание Заголовки Operation-Id: string Operation-Location: string
Other Status Codes	ErrorResponse	Произошла ошибка. Заголовки x-ms-error-code: string

Имя

Тип

Описание

201 Created

Model

Создание

Заголовки

Operation-Id: string
Operation-Location: string

Other Status Codes

ErrorResponse

Произошла ошибка.

Заголовки

x-ms-error-code: string

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

Ocp-Apim-Subscription-Key

Укажите здесь ключ ресурса службы "Речь".

Тип: apiKey
В: header

Примеры

Create a model

Create a multi style model

Create a model

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

HTTP

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



{
  "voiceName": "JessicaNeural",
  "description": "Jessica voice",
  "recipe": {
    "kind": "Default"
  },
  "projectId": "Jessica",
  "consentId": "Jessica",
  "trainingSetId": "Jessica-300"
}

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

Код состояния:: 201

Operation-Location: https://eastus.api.cognitive.microsoft.com/customvoice/operations/1f4352df-f247-40c0-a7b1-a54d017933e1?api-version=2024-02-01-preview
Operation-Id: 1f4352df-f247-40c0-a7b1-a54d017933e1

{
  "id": "Jessica",
  "voiceName": "JessicaNeural",
  "description": "Jessica voice",
  "recipe": {
    "kind": "Default",
    "version": "V7.2023.03"
  },
  "projectId": "Jessica",
  "consentId": "Jessica",
  "trainingSetId": "Jessica-300",
  "locale": "en-US",
  "engineVersion": "2023.07.04.0",
  "status": "NotStarted",
  "createdDateTime": "2023-04-01T05:30:00.000Z",
  "lastActionDateTime": "2023-04-02T10:15:30.000Z"
}

Create a multi style model

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

HTTP

PUT {endpoint}/customvoice/models/JessicaMultiStyle?api-version=2024-02-01-preview



{
  "voiceName": "JessicaMultiStyleNeural",
  "description": "Jessica multi style voice",
  "recipe": {
    "kind": "MultiStyle"
  },
  "projectId": "Jessica",
  "consentId": "Jessica",
  "trainingSetId": "Jessica-300",
  "locale": "en-US",
  "properties": {
    "presetStyles": [
      "cheerful",
      "sad"
    ],
    "styleTrainingSetIds": {
      "happy": "JessicaHappy-300",
      "myStyle2": "JessicaStyle2"
    }
  }
}

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

Код состояния:: 201

Operation-Location: https://eastus.api.cognitive.microsoft.com/customvoice/operations/a01a127a-c204-4e46-a8c1-fab01559b05b?api-version=2024-02-01-preview
Operation-Id: a01a127a-c204-4e46-a8c1-fab01559b05b

{
  "id": "JessicaMultiStyle",
  "voiceName": "JessicaMultiStyleNeural",
  "description": "Jessica multi style voice",
  "recipe": {
    "kind": "MultiStyle",
    "version": "V3.2023.06"
  },
  "projectId": "Jessica",
  "consentId": "Jessica",
  "trainingSetId": "Jessica-300",
  "locale": "en-US",
  "engineVersion": "2023.07.04.0",
  "properties": {
    "presetStyles": [
      "cheerful",
      "sad"
    ],
    "styleTrainingSetIds": {
      "happy": "JessicaHappy-300",
      "myStyle2": "JessicaStyle2"
    },
    "voiceStyles": [
      "cheerful",
      "sad",
      "happy",
      "myStyle2"
    ]
  },
  "status": "NotStarted",
  "createdDateTime": "2023-04-01T05:30:00.000Z",
  "lastActionDateTime": "2023-04-02T10:15:30.000Z"
}

Определения

Имя	Описание
Error	Ошибка верхнего уровня соответствует рекомендациям по REST API Microsoft Azure, которые доступны по адресу https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Он содержит ошибку верхнего уровня с кодом ошибки, сообщением, сведениями, целевым объектом и внутренней ошибкой с более подробными сведениями.
ErrorCode	Код ошибки верхнего уровня
ErrorResponse	Ответ об ошибке соответствует рекомендациям по REST API Microsoft Azure, которые доступны по адресу https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
InnerError	Внутренняя ошибка соответствует рекомендациям по REST API Microsoft Azure, которые доступны по адресу https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Содержит код ошибки обязательных свойств, сообщение и необязательные свойства целевой объект, внутреннюю ошибку (это может быть вложено).
Model	Объект Model
ModelFailureReason	Причина сбоя обучения модели
ModelProperties	Свойства модели
PresetStyleItem	Предустановленные стили, поддерживаемые рецептом. Голосовая модель может поддерживать эти стили без набора для обучения стилей.
Recipe	Рецепт для построения модели. Разные рецепты имеют разные возможности.
Status	Состояние ресурса.

Error

Ошибка верхнего уровня соответствует рекомендациям по REST API Microsoft Azure, которые доступны по адресу https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Он содержит ошибку верхнего уровня с кодом ошибки, сообщением, сведениями, целевым объектом и внутренней ошибкой с более подробными сведениями.

Имя	Тип	Описание
code	ErrorCode	Код ошибки верхнего уровня
details	Error[]	Дополнительные сведения об ошибке и (или) ожидаемых политиках.
innererror	InnerError	Внутренняя ошибка соответствует рекомендациям по REST API Microsoft Azure, которые доступны по адресу https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Содержит код ошибки обязательных свойств, сообщение и необязательные свойства целевой объект, внутреннюю ошибку (это может быть вложено).
message	string	Сообщение об ошибке верхнего уровня.
target	string	Источник ошибки. Например, в случае недопустимой модели это будет "model" или "model id".

ErrorCode

Код ошибки верхнего уровня

Имя	Тип	Описание
BadArgument	string
BadRequest	string
Forbidden	string
InternalServerError	string
NotFound	string
ServiceUnavailable	string
TooManyRequests	string
Unauthorized	string
UnsupportedMediaType	string

ErrorResponse

Ответ об ошибке соответствует рекомендациям по REST API Microsoft Azure, которые доступны по адресу https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Имя	Тип	Описание
error	Error	Ошибка верхнего уровня соответствует рекомендациям по REST API Microsoft Azure, которые доступны по адресу https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Он содержит ошибку верхнего уровня с кодом ошибки, сообщением, сведениями, целевым объектом и внутренней ошибкой с более подробными сведениями.

InnerError

Внутренняя ошибка соответствует рекомендациям по REST API Microsoft Azure, которые доступны по адресу https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Содержит код ошибки обязательных свойств, сообщение и необязательные свойства целевой объект, внутреннюю ошибку (это может быть вложено).

Имя	Тип	Описание
code	string	Подробный код ошибки для диагностики.
innererror	InnerError	Внутренняя ошибка соответствует рекомендациям по REST API Microsoft Azure, которые доступны по адресу https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Содержит код ошибки обязательных свойств, сообщение и необязательные свойства целевой объект, внутреннюю ошибку (это может быть вложено).
message	string	Подробное сообщение об ошибке.
target	string	Источник ошибки. Например, в случае недопустимой модели это будет "model" или "model id".

Model

Объект Model

Имя	Тип	Описание
consentId	string	Идентификатор ресурса
createdDateTime	string	Метка времени создания объекта. Метка времени закодирована в формате даты и времени ISO 8601 ("ГГГГ-ММ-ДДЧч:мм:ссЗ", см https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations. ).
description	string	Описание модели
engineVersion	string	Версия подсистемы. Обновление этой версии может получить последнюю исправление ошибок произношения.
id	string	Идентификатор ресурса
lastActionDateTime	string	Метка времени ввода текущего состояния. Метка времени закодирована в формате даты и времени ISO 8601 ("ГГГГ-ММ-ДДЧч:мм:ссЗ", см 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	Идентификатор ресурса
properties	ModelProperties	Свойства модели
recipe	Recipe	Рецепт для построения модели. Разные рецепты имеют разные возможности.
status	Status	Состояние ресурса.
trainingSetId	string	Идентификатор ресурса
voiceName	string	Название голоса

ModelFailureReason

Причина сбоя обучения модели

Имя	Тип	Описание
InaccessibleCustomerStorage	string	Клиент использует функцию "Использование собственного хранилища" в учетной записи службы "Речь". Но хранилище сейчас недоступно. Ознакомьтесь с документацией.
Internal	string	Ошибка службы пользовательской голосовой связи.
SpeakerVerificationFailed	string	Аудиозапись согласия и обучение не от одного и того же говорящего.
TerminateByUser	string	Клиент отменил обучение модели.

ModelProperties

Свойства модели

Имя	Тип	Описание
failureReason	ModelFailureReason	Причина сбоя обучения модели
presetStyles	string[]	Предустановленные стили этой модели.
styleTrainingSetIds	object	Настраиваемые стили и связанные наборы для обучения.
voiceStyles	string[]	Все стили, поддерживаемые этой моделью.

PresetStyleItem

Предустановленные стили, поддерживаемые рецептом. Голосовая модель может поддерживать эти стили без набора для обучения стилей.

Имя	Тип	Описание
female	string[]	Предустановленные стили, поддерживаемые в женской голосовой модели.
male	string[]	Предустановленные стили, поддерживаемые в мужской голосовой модели.

Recipe

Рецепт для построения модели. Разные рецепты имеют разные возможности.

Имя	Тип	Описание
datasetLocales	string[]	Языковой стандарт набора данных для обучения. Код языкового стандарта следует за BCP-47. Список языковых стандартов для преобразования текста в речь можно найти здесь https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=tts.
description	string	Описание рецепта
kind	string	Вид рецепта
maxCustomStyleNum	integer	Максимальный настраиваемый номер стиля, поддерживаемый в одной голосовой модели.
minStyleUtteranceCount	integer	Минимальное количество высказываний, необходимое для обучения каждого настраиваемого стиля.
minUtteranceCount	integer	Минимальное количество речевых фрагментов, необходимое для обучения голосовой модели с помощью этого рецепта.
modelLocales	string[]	Языковой стандарт, на котором голосовая модель может говорить с этим рецептом. Код языкового стандарта следует за BCP-47. Список языковых стандартов для преобразования текста в речь можно найти здесь https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=tts.
presetStyles	<string, PresetStyleItem>	Предустановленные стили, поддерживаемые этим рецептом в соответствии с языковым стандартом. Эти стили можно получить без набора для обучения стилей.
version	string	Версия рецепта

Status

Состояние ресурса.

Имя	Тип	Описание
Disabled	string
Disabling	string
Failed	string
NotStarted	string
Running	string
Succeeded	string

Поделиться через

Models - Create

Параметры URI

Заголовок запроса

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

Ответы

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

Ocp-Apim-Subscription-Key

Примеры

Create a model

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

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

Create a multi style model

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

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

Определения

Error

ErrorCode

ErrorResponse

InnerError

Model

ModelFailureReason

ModelProperties

PresetStyleItem

Recipe

Status

Дополнительные ресурсы