Text Dependent - Verify Profile

  • 참조
Service:
Speaker Recognition
API Version:
2021-09-05

프로필 확인
입력 오디오에 대해 기존 프로필을 확인합니다.

제한 사항:

  • 요청당 최소 오디오 입력 길이는 1초입니다.
  • 요청당 최대 오디오 입력 길이는 10초입니다.
  • 최소 오디오 SNR(신호 대 노이즈 비율)은 10dB입니다.
POST {endpoint}/speaker-recognition/verification/text-dependent/profiles/{profileId}:verify?api-version=2021-09-05

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
endpoint
 path True

string

지원되는 Cognitive Services 엔드포인트(프로토콜 및 호스트 이름( 예: https://westus.api.cognitive.microsoft.com).
profileId
 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
200 OK

RecognitionInfo

정상
Other Status Codes

SpeakerErrorInfo

실패

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:verify?api-version=2021-09-05


"{binary file date}"

Sample Response

Status code:
200 
Content-Type: application/json
Response Body
{
  "recognitionResult": "accept",
  "score": 0.63
}
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
RecognitionInfo

화자 인식 결과
ResultType

오디오가 대상 프로필에 속하나요?
SpeakerErrorInfo

스피커 오류 메시지

Error

Name 형식 Description
code

string

message

string

RecognitionInfo

화자 인식 결과

Name 형식 Description
recognitionResult

ResultType

오디오가 대상 프로필에 속하나요?
score

number

입력 오디오와 대상 음성 인쇄 간의 유사성을 나타내는 float 숫자입니다. 이 숫자는 0에서 1 사이여야 합니다. 숫자가 높을수록 유사성이 높아질 수 있습니다.

ResultType

오디오가 대상 프로필에 속하나요?

Name 형식 Description
accept

string

reject

string

SpeakerErrorInfo

스피커 오류 메시지

Name 형식 Description
error

Error