Text Independent - Create Profile

Service:

Speaker Recognition

API Version:

2021-09-05

Создание профиля
Создает новый профиль говорящего с заданным языковым стандартом

POST {endpoint}/speaker-recognition/verification/text-independent/profiles?api-version=2021-09-05

Параметры URI

Имя	В	Обязательно	Тип	Описание
endpoint	path	True	string	Поддерживаемые конечные точки Cognitive Services (протокол и имя узла, например : https://westus.api.cognitive.microsoft.com).
api-version	query	True	string	Задает версию операции, используемой для этого запроса.

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

Имя	Обязательно	Тип	Описание
Ocp-Apim-Subscription-Key	True	string

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

Имя	Обязательно	Тип	Описание
locale	True	string	Идентификатор языка, состоящий из сочетания кода языка и кода страны.

Ответы

Имя	Тип	Описание
201 Created	TiProfileInfo	Профиль говорящего успешно создан. Возвращается GUID для ссылки на созданный профиль. Headers location: string
Other Status Codes	SpeakerErrorInfo	Failure Headers x-ms-error-code: string

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

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Примеры

Successful Query

Sample Request

HTTP

POST https://westus.api.cognitive.microsoft.com/speaker-recognition/verification/text-independent/profiles?api-version=2021-09-05


{
  "locale": "en-us"
}

Sample Response

Status code:

201

Content-Type: application/json

Response Body

{
  "profileId": "49a36324-fc4b-4387-aa06-090cfbf0064f",
  "locale": "en-US",
  "profileStatus": "Active",
  "enrollmentStatus": "Enrolling",
  "createdDateTime": "2015-04-23T18:25:43.41Z",
  "lastUpdatedDateTime": "2015-04-23T18:25:43.41Z",
  "enrollmentsCount": 0,
  "enrollmentsLengthInSec": 0,
  "enrollmentsSpeechLengthInSec": 0,
  "remainingEnrollmentsSpeechLengthInSec": 20,
  "modelVersion": "2019-12-05"
}

Status code:

default

Content-Type: application/json
x-ms-error-code: Error Code

Response Body

{
  "error": {
    "code": "Error Code",
    "message": "Erro Messae"
  }
}

Определения

Имя	Описание
Error
LocaleInfo	Языковой стандарт профиля говорящего
ProfileStatusType	Состояние, представляющее текущее состояние профиля. Доступные значения: Активный: профиль активен и может использоваться, если состояние регистрации — "Зарегистрировано". Неактивный: профиль не был активирован, и необходимо отправить фразу активации.
SpeakerErrorInfo	Сообщение об ошибке говорящего
TiProfileInfo	сведения о профиле докладчика Text-Independent
TrainingStatusType	Состояние, представляющее текущее состояние профиля. Доступные значения: Регистрация: профиль не имеет голосовой печати и не готов к запросам на распознавание. Учебный курс: создается голосовая печать профиля и не может быть использована для распознавания на данный момент. Зарегистрировано: профиль имеет голосовую печать и готов к запросам на распознавание.

Error

Имя	Тип	Описание
code	string
message	string

LocaleInfo

Языковой стандарт профиля говорящего

Имя	Тип	Описание
locale	string	Идентификатор языка, состоящий из сочетания кода языка и кода страны.

ProfileStatusType

Состояние, представляющее текущее состояние профиля. Доступные значения:

• Активный: профиль активен и может использоваться, если состояние регистрации — "Зарегистрировано".
• Неактивный: профиль не был активирован, и необходимо отправить фразу активации.

Имя	Тип	Описание
Active	string
Inactive	string

SpeakerErrorInfo

Сообщение об ошибке говорящего

Имя	Тип	Описание
error	Error

TiProfileInfo

сведения о профиле докладчика Text-Independent

Имя	Тип	Описание
createdDateTime	string	Дата и время создания профиля.
enrollmentStatus	TrainingStatusType	Состояние, представляющее текущее состояние профиля. Доступные значения: Регистрация: профиль не имеет голосовой печати и не готов к запросам на распознавание. Учебный курс: создается голосовая печать профиля и не может быть использована для распознавания на данный момент. Зарегистрировано: профиль имеет голосовую печать и готов к запросам на распознавание.
enrollmentsCount	integer	Количество аудиозаписей, принятых для этого профиля.
enrollmentsLengthInSec	number	Общая продолжительность аудиоданных регистрации, принятых для этого профиля, в секундах.
enrollmentsSpeechLengthInSec	number	Суммирование чистой речи (это объем звука после удаления безмолвных и не речевых сегментов) во всех регистрациях профиля в секундах.
lastUpdatedDateTime	string	Последняя дата и время обновления профиля.
locale	string	Идентификатор языка, состоящий из сочетания кода языка и кода страны.
modelVersion	string	Дата, указывающая модель, назначенную этому профилю. Формат : гггг-мм-дд. Если профиль не имеет регистраций, это значение будет пустым.
profileId	string	Уникальный идентификатор для идентификатора профиля (GUID).
profileStatus	ProfileStatusType	Состояние, представляющее текущее состояние профиля. Доступные значения: Активный: профиль активен и может использоваться, если состояние регистрации — "Зарегистрировано". Неактивный: профиль не был активирован, и необходимо отправить фразу активации.
remainingEnrollmentsSpeechLengthInSec	number	Объем чистой речи (то есть объем звука после удаления безмолвных и не речевых сегментов), необходимый для завершения регистрации профиля в секундах.

TrainingStatusType

Состояние, представляющее текущее состояние профиля. Доступные значения:

• Регистрация: профиль не имеет голосовой печати и не готов к запросам на распознавание.
• Учебный курс: создается голосовая печать профиля и не может быть использована для распознавания на данный момент.
• Зарегистрировано: профиль имеет голосовую печать и готов к запросам на распознавание.

Имя	Тип	Описание
Enrolled	string
Enrolling	string
Training	string