Text Dependent - Create Enrollment
프로필 등록
기존 프로필에 등록을 추가합니다.
요청된 등록 오디오의 최소 수에 도달하면 음성 인쇄가 만들어집니다.
이전에 음성 인쇄를 만든 경우 새 음성 인쇄를 포함한 모든 기존 등록 오디오에서 다시 생성됩니다.
제한 사항:
- 요청당 최소 오디오 입력 길이는 1초입니다.
- 요청당 최대 오디오 입력 길이는 10초입니다.
- 음성 인쇄를 만들기 위한 최소 등록 수는 3입니다.
- 음성 인쇄를 만들기 위한 최대 등록 수는 50개입니다.
- 최소 오디오 SNR(신호 대 노이즈 비율)은 2dB입니다.
제약 조건:
- 첫 번째 등록은 기존 암호와 일치해야 합니다.
- 첫 번째 등록 이후의 모든 등록은 첫 번째 등록에 사용된 것과 동일한 암호를 사용해야 합니다.
POST {endpoint}/speaker-recognition/verification/text-dependent/profiles/{profileId}/enrollments?api-version=2021-09-05
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
endpoint
|
path | True |
string |
지원되는 Cognitive Services 엔드포인트(프로토콜 및 호스트 이름( 예: https://westus.api.cognitive.microsoft.com). |
profile
|
path | True |
string uuid |
프로필 ID(guid)의 고유 식별자입니다. |
api-version
|
query | True |
string |
이 요청에 사용할 작업의 버전을 지정합니다. |
요청 헤더
Media Types: "audio/wav; codecs=audio/pcm"
Name | 필수 | 형식 | Description |
---|---|---|---|
Ocp-Apim-Subscription-Key | True |
string |
요청 본문
Media Types: "audio/wav; codecs=audio/pcm"
Name | 형식 | Description |
---|---|---|
audioData |
object |
이진 오디오 파일. 지원되는 형식은 오디오/물결선입니다. codecs=audio/pcm. 최대 5MB의 오디오를 지원합니다. |
응답
Name | 형식 | Description |
---|---|---|
201 Created |
생성일 |
|
Other Status Codes |
실패 Headers x-ms-error-code: string |
보안
Ocp-Apim-Subscription-Key
Type:
apiKey
In:
header
예제
Successful Query
Sample Request
POST https://westus.api.cognitive.microsoft.com/speaker-recognition/verification/text-dependent/profiles/49a36324-fc4b-4387-aa06-090cfbf0064f/enrollments?api-version=2021-09-05
"{binary file date}"
Sample Response
Content-Type: application/json
{
"profileId": "49a36324-fc4b-4387-aa06-090cfbf0064f",
"enrollmentStatus": "Enrolling",
"enrollmentsCount": 1,
"enrollmentsLengthInSec": 1.83,
"enrollmentsSpeechLengthInSec": 1.35,
"remainingEnrollmentsCount": 2,
"passPhrase": "my voice is my passport verify me",
"audioLengthInSec": 1.83,
"audioSpeechLengthInSec": 1.35
}
Content-Type: application/json
x-ms-error-code: Error Code
{
"error": {
"code": "Error Code",
"message": "Erro Messae"
}
}
정의
Name | Description |
---|---|
Error | |
Speaker |
스피커 오류 메시지 |
Td |
Text-Dependent Speaker 프로필 등록 정보 |
Training |
프로필의 현재 상태를 나타내는 상태입니다. 사용 가능한 값은 다음과 같습니다.
|
Error
Name | 형식 | Description |
---|---|---|
code |
string |
|
message |
string |
SpeakerErrorInfo
스피커 오류 메시지
Name | 형식 | Description |
---|---|---|
error |
TdEnrollmentInfo
Text-Dependent Speaker 프로필 등록 정보
Name | 형식 | Description |
---|---|---|
audioLengthInSec |
number |
이 등록 오디오 길이(초)입니다. |
audioSpeechLengthInSec |
number |
이 등록 오디오 순수 음성(무음 및 비 음성 세그먼트를 제거한 후의 오디오 양) 길이(초)입니다. |
enrollmentStatus |
프로필의 현재 상태를 나타내는 상태입니다. 사용 가능한 값은 다음과 같습니다.
|
|
enrollmentsCount |
integer |
이 프로필에 허용되는 등록 오디오 수입니다. |
enrollmentsLengthInSec |
number |
이 프로필에 허용되는 등록 오디오의 총 길이(초)입니다. |
enrollmentsSpeechLengthInSec |
number |
모든 프로필 등록에서 순수 음성(무음 및 비 음성 세그먼트를 제거한 후의 오디오 양)의 합계(초)입니다. |
passPhrase |
string |
이 등록과 연결된 암호입니다. |
profileId |
string |
프로필 ID(guid)의 고유 식별자입니다. |
remainingEnrollmentsCount |
integer |
프로필 등록을 완료하는 데 필요한 등록 오디오 수입니다. |
TrainingStatusType
프로필의 현재 상태를 나타내는 상태입니다. 사용 가능한 값은 다음과 같습니다.
- 등록: 프로필에 음성 인쇄가 없으며 인식 요청에 사용할 준비가 되지 않았습니다.
- 교육: 프로필의 음성 인쇄가 생성되고 있으며 현재 인식에 사용할 수 없습니다.
- 등록됨: 프로필에 음성 인쇄가 있고 인식 요청에 사용할 준비가 되었습니다.
Name | 형식 | Description |
---|---|---|
Enrolled |
string |
|
Enrolling |
string |
|
Training |
string |