Text Dependent - Create Enrollment

Service:

Speaker Recognition

API Version:

2021-09-05

Profiel inschrijven
Hiermee voegt u een inschrijving toe aan een bestaand profiel. Als het minimum aantal aangevraagde registratieaudios is bereikt, wordt er een spraakafdruk gemaakt. Als de spraakafdruk eerder is gemaakt, wordt deze opnieuw gemaakt op basis van alle bestaande inschrijvingsaudio, inclusief de nieuwe.

Beperkingen:

• Minimale audio-invoerlengte per aanvraag is 1 seconde
• Maximale lengte van audio-invoer per aanvraag is 10 seconden
• Het minimumaantal inschrijvingen voor het maken van een spraakafdruk is 3
• Maximum aantal inschrijvingen voor het maken van een spraakafdruk is 50
• De minimale signaal-ruisverhouding (SNR) voor audio is 2dB

Beperkingen:

• De eerste inschrijving moet overeenkomen met een bestaande wachtwoordzin.
• Alle inschrijvingen na de eerste moeten dezelfde wachtwoordzin gebruiken die in de eerste inschrijving is gebruikt.

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

URI-parameters

Name	In	Vereist	Type	Description
endpoint	path	True	string	Ondersteunde Cognitive Services-eindpunten (protocol en hostnaam, bijvoorbeeld: https://westus.api.cognitive.microsoft.com).
profileId	path	True	string uuid	Unieke id voor profiel-id (GUID).
api-version	query	True	string	Hiermee geeft u de versie van de bewerking te gebruiken voor deze aanvraag.

Aanvraagkoptekst

Media Types: "audio/wav; codecs=audio/pcm"

Name	Vereist	Type	Description
Ocp-Apim-Subscription-Key	True	string

Aanvraagbody

Media Types: "audio/wav; codecs=audio/pcm"

Name	Type	Description
audioData	object	Binair audiobestand. Ondersteunde indelingen zijn audio/wav; codecs=audio/pcm. Ondersteunt audio tot 5 MB.

Antwoorden

Name	Type	Description
201 Created	TdEnrollmentInfo	Gemaakt
Other Status Codes	SpeakerErrorInfo	Fout Headers x-ms-error-code: string

Beveiliging

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Voorbeelden

Successful Query

Sample Request

HTTP

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

Status code:

201

Content-Type: application/json

Response Body

{
  "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
}

Status code:

default

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

Response Body

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

Definities

Name	Description
Error
SpeakerErrorInfo	Foutbericht van spreker
TdEnrollmentInfo	inschrijvingsgegevens voor Text-Dependent speakerprofiel
TrainingStatusType	Status die de huidige status van het profiel aangeeft. Beschikbare waarden zijn: Inschrijven: het profiel heeft geen spraakafdruk en is niet gereed voor herkenningsaanvragen. Training: spraakafdruk van het profiel wordt gemaakt en kan momenteel niet worden gebruikt voor herkenning. Ingeschreven: het profiel heeft een spraakafdruk en is klaar voor herkenningsaanvragen.

Error

Name	Type	Description
code	string
message	string

SpeakerErrorInfo

Foutbericht van spreker

Name	Type	Description
error	Error

TdEnrollmentInfo

inschrijvingsgegevens voor Text-Dependent speakerprofiel

Name	Type	Description
audioLengthInSec	number	Deze audiolengte voor inschrijving in seconden.
audioSpeechLengthInSec	number	Deze registratie audio pure spraak (dit is de hoeveelheid audio na het verwijderen van stilte en niet-spraaksegmenten) lengte in seconden.
enrollmentStatus	TrainingStatusType	Status die de huidige status van het profiel aangeeft. Beschikbare waarden zijn: Inschrijven: het profiel heeft geen spraakafdruk en is niet gereed voor herkenningsaanvragen. Training: spraakafdruk van het profiel wordt gemaakt en kan momenteel niet worden gebruikt voor herkenning. Ingeschreven: het profiel heeft een spraakafdruk en is klaar voor herkenningsaanvragen.
enrollmentsCount	integer	Het aantal inschrijvingsaudio dat voor dit profiel is geaccepteerd.
enrollmentsLengthInSec	number	Totale lengte van inschrijvingsaudio geaccepteerd voor dit profiel in seconden.
enrollmentsSpeechLengthInSec	number	Optelsom van pure spraak (de hoeveelheid audio na het verwijderen van stilte- en niet-spraaksegmenten) in alle profielinschrijvingen in enkele seconden.
passPhrase	string	Wachtwoordzin die is gekoppeld aan deze inschrijving.
profileId	string	Unieke id voor profiel-id (GUID).
remainingEnrollmentsCount	integer	Het aantal inschrijvingsaudio dat nodig is om de profielinschrijving te voltooien.

TrainingStatusType

Status die de huidige status van het profiel aangeeft. Beschikbare waarden zijn:

• Inschrijven: het profiel heeft geen spraakafdruk en is niet gereed voor herkenningsaanvragen.
• Training: spraakafdruk van het profiel wordt gemaakt en kan momenteel niet worden gebruikt voor herkenning.
• Ingeschreven: het profiel heeft een spraakafdruk en is klaar voor herkenningsaanvragen.

Name	Type	Description
Enrolled	string
Enrolling	string
Training	string