Text Independent - Create Profile

Dienst:

Speaker Recognition

API-Version:

2021-09-05

Profil erstellen
Erstellt ein neues Sprecherprofil mit angegebenem Gebietsschema.

POST {endpoint}/speaker-recognition/verification/text-independent/profiles?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
api-version	query	True	string	Gibt die Version des für die Anforderung zu verwendenden Vorgangs an.

Anforderungsheader

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

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
locale	True	string	Sprachbezeichner, der aus einer Kombination aus Sprachcode und Ländercode besteht.

Antworten

Name	Typ	Beschreibung
201 Created	TiProfileInfo	Sprecherprofil erfolgreich erstellt. GuiD wird zurückgegeben, um auf das erstellte Profil zu verweisen. Header location: string
Other Status Codes	SpeakerErrorInfo	Fehler 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-independent/profiles?api-version=2021-09-05


{
  "locale": "en-us"
}

Beispiel für eine Antwort

Statuscode:

201

Content-Type: application/json

{
  "profileId": "49a36324-fc4b-4387-aa06-090cfbf0064f",
  "locale": "en-US",
  "profileStatus": "Active",
  "enrollmentStatus": "Enrolling",
  "createdDateTime": "2015-04-23T18:25:43.41Z",
  "lastUpdatedDateTime": "2015-04-23T18:25:43.41Z",
  "enrollmentsCount": 0,
  "enrollmentsLengthInSec": 0,
  "enrollmentsSpeechLengthInSec": 0,
  "remainingEnrollmentsSpeechLengthInSec": 20,
  "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
LocaleInfo	Gebietsschema des Sprecherprofils
ProfileStatusType	Status, der den aktuellen Status des Profils darstellt. Folgende Werte sind verfügbar: Aktiv: Das Profil ist aktiv und kann verwendet werden, wenn die Registrierung status "Registriert" lautet. Inaktiv: Das Profil wurde nicht aktiviert, und ein Aktivierungsbegriff muss übermittelt werden.
SpeakerErrorInfo	Sprecherfehlermeldung
TiProfileInfo	Text-Independent Lautsprecherprofilinformationen
TrainingStatusType	Status, der den aktuellen Status des Profils darstellt. Folgende Werte sind verfügbar: Registrierung: Das Profil verfügt über keinen Sprachdruck und ist nicht für Erkennungsanforderungen bereit. Schulung: Der Sprachdruck des Profils wird erstellt und kann derzeit nicht für die Erkennung verwendet werden. Registriert: Das Profil verfügt über eine Sprachausgabe und ist für Erkennungsanforderungen bereit.

Error

Name	Typ	Beschreibung
code	string
message	string

LocaleInfo

Gebietsschema des Sprecherprofils

Name	Typ	Beschreibung
locale	string	Sprachbezeichner, der aus einer Kombination aus Sprachcode und Ländercode besteht.

ProfileStatusType

Status, der den aktuellen Status des Profils darstellt. Folgende Werte sind verfügbar:

• Aktiv: Das Profil ist aktiv und kann verwendet werden, wenn die Registrierung status "Registriert" lautet.
• Inaktiv: Das Profil wurde nicht aktiviert, und ein Aktivierungsbegriff muss übermittelt werden.

Name	Typ	Beschreibung
Active	string
Inactive	string

SpeakerErrorInfo

Sprecherfehlermeldung

Name	Typ	Beschreibung
error	Error

TiProfileInfo

Text-Independent Lautsprecherprofilinformationen

Name	Typ	Beschreibung
createdDateTime	string	Datetime für die Profilerstellung.
enrollmentStatus	TrainingStatusType	Status, der den aktuellen Status des Profils darstellt. Folgende Werte sind verfügbar: Registrierung: Das Profil verfügt über keinen Sprachdruck und ist nicht für Erkennungsanforderungen bereit. Schulung: Der Sprachdruck des Profils wird erstellt und kann derzeit nicht für die Erkennung verwendet werden. Registriert: Das Profil verfügt über eine Sprachausgabe und ist für Erkennungsanforderungen bereit.
enrollmentsCount	integer	Anzahl der für dieses Profil akzeptierten Registrierungsaudios.
enrollmentsLengthInSec	number	Gesamtlänge der für dieses Profil akzeptierten Registrierungsaudios in Sekunden.
enrollmentsSpeechLengthInSec	number	Summation der reinen Sprache (dies ist die Audiomenge nach dem Entfernen von Stille und Nicht-Sprachsegmenten) über alle Profilregistrierungen in Sekunden.
lastUpdatedDateTime	string	Datum der letzten Aktualisierung des Profils.
locale	string	Sprachbezeichner, der aus einer Kombination aus Sprachcode und Ländercode besteht.
modelVersion	string	Datum, das das diesem Profil zugewiesene Modell angibt. Das Format ist jjjj-mm-tt. Wenn das Profil keine Registrierungen aufweist, ist dieser Wert leer.
profileId	string	Eindeutiger Bezeichner für die Profil-ID (guid).
profileStatus	ProfileStatusType	Status, der den aktuellen Status des Profils darstellt. Folgende Werte sind verfügbar: Aktiv: Das Profil ist aktiv und kann verwendet werden, wenn die Registrierung status "Registriert" lautet. Inaktiv: Das Profil wurde nicht aktiviert, und ein Aktivierungsbegriff muss übermittelt werden.
remainingEnrollmentsSpeechLengthInSec	number	Die Menge der reinen Sprache (also die Menge an Audiodaten nach dem Entfernen von Stille- und Spracherkennungssegmenten), die erforderlich ist, um die Profilregistrierung in Sekunden abzuschließen.

TrainingStatusType

Status, der den aktuellen Status des Profils darstellt. Folgende Werte sind verfügbar:

• Registrierung: Das Profil verfügt über keinen Sprachdruck und ist nicht für Erkennungsanforderungen bereit.
• Schulung: Der Sprachdruck des Profils wird erstellt und kann derzeit nicht für die Erkennung verwendet werden.
• Registriert: Das Profil verfügt über eine Sprachausgabe und ist für Erkennungsanforderungen bereit.

Name	Typ	Beschreibung
Enrolled	string
Enrolling	string
Training	string