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 매개 변수

Name	In(다음 안에)	필수	형식	Description
endpoint	path	True	string	지원되는 Cognitive Services 엔드포인트(프로토콜 및 호스트 이름( 예: https://westus.api.cognitive.microsoft.com).
api-version	query	True	string	이 요청에 사용할 작업의 버전을 지정합니다.

요청 헤더

Name	필수	형식	Description
Ocp-Apim-Subscription-Key	True	string

요청 본문

Name	필수	형식	Description
locale	True	string	언어 코드와 국가 코드의 조합으로 구성된 언어 식별자입니다.

응답

Name	형식	Description
201 Created	TiProfileInfo	스피커 프로필이 성공적으로 생성되었습니다. GUID는 생성된 프로필을 참조하기 위해 반환됩니다. Headers location: string
Other Status Codes	SpeakerErrorInfo	실패 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"
  }
}

정의

Name	Description
Error
LocaleInfo	스피커 프로필 로캘
ProfileStatusType	프로필의 현재 상태를 나타내는 상태입니다. 사용 가능한 값은 다음과 같습니다. 활성: 프로필이 활성 상태이며 등록 상태 '등록됨'인 경우 사용할 수 있습니다. 비활성: 프로필이 활성화되지 않았으며 활성화 구를 제출해야 합니다.
SpeakerErrorInfo	스피커 오류 메시지
TiProfileInfo	Text-Independent Speaker 프로필 정보
TrainingStatusType	프로필의 현재 상태를 나타내는 상태입니다. 사용 가능한 값은 다음과 같습니다. 등록: 프로필에 음성 인쇄가 없으며 인식 요청에 사용할 준비가 되지 않았습니다. 교육: 프로필의 음성 인쇄가 생성되고 있으며 현재 인식에 사용할 수 없습니다. 등록됨: 프로필에 음성 인쇄가 있고 인식 요청에 사용할 준비가 되었습니다.

Error

Name	형식	Description
code	string
message	string

LocaleInfo

스피커 프로필 로캘

Name	형식	Description
locale	string	언어 코드와 국가 코드의 조합으로 구성된 언어 식별자입니다.

ProfileStatusType

프로필의 현재 상태를 나타내는 상태입니다. 사용 가능한 값은 다음과 같습니다.

• 활성: 프로필이 활성 상태이며 등록 상태 '등록됨'인 경우 사용할 수 있습니다.
• 비활성: 프로필이 활성화되지 않았으며 활성화 구를 제출해야 합니다.

Name	형식	Description
Active	string
Inactive	string

SpeakerErrorInfo

스피커 오류 메시지

Name	형식	Description
error	Error

TiProfileInfo

Text-Independent Speaker 프로필 정보

Name	형식	Description
createdDateTime	string	프로필 만들기 날짜/시간입니다.
enrollmentStatus	TrainingStatusType	프로필의 현재 상태를 나타내는 상태입니다. 사용 가능한 값은 다음과 같습니다. 등록: 프로필에 음성 인쇄가 없으며 인식 요청에 사용할 준비가 되지 않았습니다. 교육: 프로필의 음성 인쇄가 생성되고 있으며 현재 인식에 사용할 수 없습니다. 등록됨: 프로필에 음성 인쇄가 있고 인식 요청에 사용할 준비가 되었습니다.
enrollmentsCount	integer	이 프로필에 허용되는 등록 오디오 수입니다.
enrollmentsLengthInSec	number	이 프로필에 허용되는 등록 오디오의 총 길이(초)입니다.
enrollmentsSpeechLengthInSec	number	모든 프로필 등록에서 순수 음성(무음 및 비 음성 세그먼트를 제거한 후의 오디오 양)의 합계(초)입니다.
lastUpdatedDateTime	string	프로필이 업데이트된 마지막 날짜/시간입니다.
locale	string	언어 코드와 국가 코드의 조합으로 구성된 언어 식별자입니다.
modelVersion	string	이 프로필에 할당된 모델을 지정하는 날짜입니다. 형식은 yyyy-mm-dd입니다. 프로필에 등록이 없으면 이 값은 비어 있습니다.
profileId	string	프로필 ID(guid)의 고유 식별자입니다.
profileStatus	ProfileStatusType	프로필의 현재 상태를 나타내는 상태입니다. 사용 가능한 값은 다음과 같습니다. 활성: 프로필이 활성 상태이며 등록 상태 '등록됨'인 경우 사용할 수 있습니다. 비활성: 프로필이 활성화되지 않았으며 활성화 구를 제출해야 합니다.
remainingEnrollmentsSpeechLengthInSec	number	프로필 등록을 몇 초 만에 완료하는 데 필요한 순수 음성 양(무음 및 비 음성 세그먼트를 제거한 후의 오디오 양)입니다.

TrainingStatusType

프로필의 현재 상태를 나타내는 상태입니다. 사용 가능한 값은 다음과 같습니다.

• 등록: 프로필에 음성 인쇄가 없으며 인식 요청에 사용할 준비가 되지 않았습니다.
• 교육: 프로필의 음성 인쇄가 생성되고 있으며 현재 인식에 사용할 수 없습니다.
• 등록됨: 프로필에 음성 인쇄가 있고 인식 요청에 사용할 준비가 되었습니다.

Name	형식	Description
Enrolled	string
Enrolling	string
Training	string