다음을 통해 공유


Text Dependent - List Profiles

프로필 나열
프로필 집합을 검색합니다. 프로필은 ProfileId별로 사전순으로 정렬됩니다.

GET {endpoint}/speaker-recognition/verification/text-dependent/profiles?api-version=2021-09-05
GET {endpoint}/speaker-recognition/verification/text-dependent/profiles?api-version=2021-09-05&maxpagesize={maxpagesize}

URI 매개 변수

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

string

지원되는 Cognitive Services 엔드포인트(프로토콜 및 호스트 이름( 예: https://westus.api.cognitive.microsoft.com).

api-version
query True

string

이 요청에 사용할 작업의 버전을 지정합니다.

maxpagesize
query

integer

반환할 프로필 수입니다. 기본값은 100이고 최대값은 500입니다.

요청 헤더

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

string

응답

Name 형식 Description
200 OK

TdProfileInfoList

정상

Other Status Codes

SpeakerErrorInfo

실패

헤더

x-ms-error-code: string

보안

Ocp-Apim-Subscription-Key

형식: apiKey
In(다음 안에): header

예제

Successful Query

샘플 요청

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

샘플 응답

Content-Type: application/json
{
  "value": [
    {
      "profileId": "49a36324-fc4b-4387-aa06-090cfbf0064f",
      "locale": "en-US",
      "enrollmentStatus": "Enrolling",
      "createdDateTime": "2015-04-23T18:25:43.41Z",
      "lastUpdatedDateTime": "2015-04-23T19:34:51.52Z",
      "enrollmentsCount": 1,
      "enrollmentsLengthInSec": 1.83,
      "enrollmentsSpeechLengthInSec": 1.35,
      "remainingEnrollmentsCount": 2,
      "modelVersion": "2019-12-05"
    }
  ],
  "nextLink": "{opaqueUrl}"
}
Content-Type: application/json
x-ms-error-code: Error Code
{
  "error": {
    "code": "Error Code",
    "message": "Erro Messae"
  }
}

정의

Name Description
Error
SpeakerErrorInfo

스피커 오류 메시지

TdProfileInfo

Text-Dependent Speaker 프로필 정보

TdProfileInfoList

Text-Dependent Speaker 프로필 정보 목록

TrainingStatusType

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

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

Error

Name 형식 Description
code

string

message

string

SpeakerErrorInfo

스피커 오류 메시지

Name 형식 Description
error

Error

TdProfileInfo

Text-Dependent 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)의 고유 식별자입니다.

remainingEnrollmentsCount

integer

프로필 등록을 완료하는 데 필요한 등록 오디오 수입니다.

TdProfileInfoList

Text-Dependent Speaker 프로필 정보 목록

Name 형식 Description
nextLink

string

value

TdProfileInfo[]

Text-Dependent Speaker 프로필 정보

TrainingStatusType

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

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

string

Enrolling

string

Training

string