Text Dependent - Reset Profile

Dienst:

Azure AI Services

API-Version:

2021-09-05

Profil zurücksetzen
Setzt das vorhandene Profil auf den ursprünglichen Zustand nach der Erstellung zurück. Beim Zurücksetzungsvorgang wird Folgendes durchgeführt:

• Aktualisiert enrollmentStatus für die Registrierung.
• Aktualisiert lastUpdatedDateTime.
• Aktualisiert enrollmentsCount auf 0.
• Aktualisiert enrollmentsLength auf 0.
• Aktualisiert enrollmentsSpeechLength auf 0.
• Aktualisiert remainingEnrollmentsCount auf die anfängliche erforderliche Zahl.
• Entfernt alle zugeordneten Registrierungen aus dem Speicher.
• Entfernt die ausgewählte Passphrasenzuordnung.
• Setzt den Wert von modelVersion zurück.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
endpoint	path	True	string	Unterstützte Cognitive Services-Endpunkte (Protokoll und Hostname, z. B. https://westus.api.cognitive.microsoft.com).
profileId	path	True	string (uuid)	Eindeutiger Bezeichner für die Profil-ID (GUID).
api-version	query	True	string	Gibt die Version des Vorgangs an, der für diese Anforderung verwendet werden soll.

Anforderungsheader

Name	Erforderlich	Typ	Beschreibung
Ocp-Apim-Subscription-Key	True	string

Antworten

Name	Typ	Beschreibung
200 OK	TdProfileInfo	Das Lautsprecherprofil wurde erfolgreich zurückgesetzt. Das Profil wird mit Zurücksetzungswerten zurückgegeben. Header Location: string
Other Status Codes	SpeakerErrorInfo	Versagen Header x-ms-error-code: string

Sicherheit

Ocp-Apim-Subscription-Key

Typ: apiKey
In: header

Beispiele

Successful Query

Beispielanforderung

HTTP

POST https://westus.api.cognitive.microsoft.com/speaker-recognition/verification/text-dependent/profiles/49a36324-fc4b-4387-aa06-090cfbf0064f:reset?api-version=2021-09-05

Beispiel für eine Antwort

Statuscode:

200

Content-Type: application/json

{
  "profileId": "49a36324-fc4b-4387-aa06-090cfbf0064f",
  "locale": "en-US",
  "enrollmentStatus": "Enrolling",
  "createdDateTime": "2015-04-23T18:25:43.41Z",
  "lastUpdatedDateTime": "2015-04-23T18:25:43.41Z",
  "enrollmentsCount": 0,
  "enrollmentsLengthInSec": 0,
  "enrollmentsSpeechLengthInSec": 0,
  "remainingEnrollmentsCount": 3,
  "modelVersion": "2019-12-05"
}

Statuscode:

default

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

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

Definitionen

Name	Beschreibung
Error
SpeakerErrorInfo	Sprecherfehlermeldung
TdProfileInfo	Text-Dependent Sprecherprofilinformationen
TrainingStatusType	Status, der den aktuellen Status des Profils darstellt. Verfügbare Werte sind: Registrieren: Das Profil hat keinen Sprachdruck und ist nicht für Erkennungsanforderungen bereit. Schulung: Die Sprachausgabe des Profils wird erstellt und kann derzeit nicht für die Erkennung verwendet werden. Registriert: Das Profil verfügt über einen Sprachdruck und kann für Erkennungsanforderungen bereit sein.

Error

Objekt

Name	Typ	Beschreibung
code	string
message	string

SpeakerErrorInfo

Objekt

Sprecherfehlermeldung

Name	Typ	Beschreibung
error	Error

TdProfileInfo

Objekt

Text-Dependent Sprecherprofilinformationen

Name	Typ	Beschreibung
createdDateTime	string (date-time)	Datum und Uhrzeit der Profilerstellung.
enrollmentStatus	TrainingStatusType	Status, der den aktuellen Status des Profils darstellt. Verfügbare Werte sind: Registrieren: Das Profil hat keinen Sprachdruck und ist nicht für Erkennungsanforderungen bereit. Schulung: Die Sprachausgabe des Profils wird erstellt und kann derzeit nicht für die Erkennung verwendet werden. Registriert: Das Profil verfügt über einen Sprachdruck und kann für Erkennungsanforderungen bereit sein.
enrollmentsCount	integer	Die Anzahl der Registrierungsaudios, die für dieses Profil akzeptiert wurden.
enrollmentsLengthInSec	number	Gesamtdauer der Registrierungsaudios, die für dieses Profil in Sekunden akzeptiert wurden.
enrollmentsSpeechLengthInSec	number	Summe der reinen Spracherkennung (d. h. die Audiomenge nach dem Entfernen von Stille und Nicht-Sprachsegmenten) in allen Profilregistrierungen in Sekunden.
lastUpdatedDateTime	string (date-time)	Datum der letzten Aktualisierung des Profils.
locale	string pattern: ^[a-zA-Z]{2}-?[a-zA-Z]{2}$	Sprach-ID, die aus einer Kombination aus Sprachcode und Ländercode besteht.
modelVersion	string (date)	Datum, das das diesem Profil zugewiesene Modell angibt. Format ist yyyy-mm-dd. Wenn das Profil keine Registrierungen aufweist, ist dieser Wert leer.
profileId	string (uuid)	Eindeutiger Bezeichner für die Profil-ID (GUID).
remainingEnrollmentsCount	integer	Die Anzahl der Registrierungsaudios, die zum Abschließen der Profilregistrierung erforderlich sind.

TrainingStatusType

Enumeration

Status, der den aktuellen Status des Profils darstellt. Verfügbare Werte sind:

• Registrieren: Das Profil hat keinen Sprachdruck und ist nicht für Erkennungsanforderungen bereit.
• Schulung: Die Sprachausgabe des Profils wird erstellt und kann derzeit nicht für die Erkennung verwendet werden.
• Registriert: Das Profil verfügt über einen Sprachdruck und kann für Erkennungsanforderungen bereit sein.

Wert	Beschreibung
Enrolled
Enrolling
Training