Text Dependent - List Profiles

Profile auflisten
Ruft einen Satz von Profilen ab. Profile werden alphabetisch nach ProfileId sortiert.

GET {Endpoint}/speaker/verification/v2.0/text-dependent/profiles
GET {Endpoint}/speaker/verification/v2.0/text-dependent/profiles?$top={$top}

URI-Parameter

Name In Required Type Description
Endpoint
path True
  • string

Unterstützt Cognitive Services Endpunkte (Protokoll und Hostname, z. B.: https://westus.api.cognitive.microsoft.com) .

$top
query
  • integer

Die Anzahl der zurückzugebenden Profile. Der Standardwert ist 100, und der Höchstwert ist 500.

Anforderungsheader

Name Required Type Description
Ocp-Apim-Subscription-Key True
  • string

Antworten

Name Type Description
200 OK

OK

400 Bad Request

Ungültige Anforderung

  • InvalidArgument: Ungültiger $top Parameterwert. Der Wert sollte eine positive ganze Zahl im Bereich [1, 500] sein.
  • InvalidArgument: Ungültiger $continuationToken Wert. $continuationToken müssen von einem vorherigen API-Aufruf generiert werden.
  • InvalidArgument: $filter Parameter wird nicht unterstützt.
  • InvalidArgument: $skip Parameter wird nicht unterstützt.
  • InvalidArgument: $orderBy Parameter wird nicht unterstützt.
  • InvalidArgument: $delta Parameter wird nicht unterstützt.
401 Unauthorized

Die Anforderung ist nicht autorisiert. Stellen Sie sicher, dass der Abonnementschlüssel enthalten und gültig ist.

500 Internal Server Error

Interner Serverfehler.

Other Status Codes

Die Durchsatzgrenze wurde überschritten.

Sicherheit

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Beispiele

Successful Query

Sample Request

GET {Endpoint}/speaker/verification/v2.0/text-dependent/profiles
Ocp-Apim-Subscription-Key: {API key}

Sample Response

Content-Type: application/json
{
  "profiles": [
    {
      "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,
      "enrollmentsLength": 1.83,
      "enrollmentsSpeechLength": 1.35,
      "remainingEnrollmentsCount": 2,
      "modelVersion": "2019-12-05"
    }
  ],
  "@nextLink": "https://{Endpoint}/text-independent/profiles?$top=35&$continuationToken=U21pdGg1QmVuOTk5"
}
Content-Type: application/json
{
  "error": {
    "code": "InvalidArgument",
    "message": "Invalid $top parameter value. Value should be positive integer in the range [1, 500]"
  }
}
Content-Type: application/json
{
  "error": {
    "code": "Unauthorized",
    "message": "Request is not authorized. Make sure subscription key is included and valid."
  }
}
Content-Type: application/json
{
  "error": {
    "code": "RateLimit",
    "message": "Rate limit is exceeded."
  }
}
Content-Type: application/json
{
  "error": {
    "code": "InternalServerError",
    "message": "Internal Server Error."
  }
}

Definitionen

Error

Sprecherfehlermeldung

TdProfileInfo

informationen zum Text-Dependent Speaker-Profil

TdProfileInfoList

Text-Dependent Liste mit Informationen zum Sprecherprofil

TrainingStatusType

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

  • Registrieren: Das Profil verfügt über keinen Sprachdruck und ist nicht für Erkennungsanforderungen bereit.
  • Training: Der Stimmdruck des Profils wird erstellt und kann derzeit nicht für die Erkennung verwendet werden.
  • Registriert: Das Profil verfügt über einen Sprachdruck und ist für Erkennungsanforderungen bereit.

Error

Sprecherfehlermeldung

Name Type Description
error

TdProfileInfo

informationen zum Text-Dependent Speaker-Profil

Name Type Description
createdDateTime
  • string

Datum/Uhrzeit der Profilerstellung.

enrollmentStatus

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

  • Registrieren: Das Profil verfügt über keinen Sprachdruck und ist nicht für Erkennungsanforderungen bereit.
  • Training: Der Stimmdruck des Profils wird erstellt und kann derzeit nicht für die Erkennung verwendet werden.
  • Registriert: Das Profil verfügt über einen Sprachdruck und ist für Erkennungsanforderungen bereit.
enrollmentsCount
  • integer

Anzahl der zulässigen Audioaufnahmen für dieses Profil.

enrollmentsLength
  • number

Gesamtlänge der für dieses Profil akzeptierten Registrierungsaudios in Sekunden.

enrollmentsSpeechLength
  • number

Summierung der reinen Sprache (d. h. die Audiomenge nach dem Entfernen von Stille und Nicht-Sprachsegmenten) für alle Profilregistrierungen in Sekunden.

lastUpdatedDateTime
  • string

Letzter datetime-Zeitpunkt, zu dem das Profil aktualisiert wurde.

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 yyyy-mm-dd. Wenn das Profil über keine Registrierungen verfügt, ist dieser Wert leer.

profileId
  • string

Eindeutiger Bezeichner für die Profil-ID (GUID).

remainingEnrollmentsCount
  • integer

Anzahl der Registrierungsaudios, die zum Abschließen der Profilregistrierung erforderlich sind.

TdProfileInfoList

Text-Dependent Liste mit Informationen zum Sprecherprofil

Name Type Description
@nextLink
  • string
profiles

informationen zum Text-Dependent Speaker-Profil

TrainingStatusType

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

  • Registrieren: Das Profil verfügt über keinen Sprachdruck und ist nicht für Erkennungsanforderungen bereit.
  • Training: Der Stimmdruck des Profils wird erstellt und kann derzeit nicht für die Erkennung verwendet werden.
  • Registriert: Das Profil verfügt über einen Sprachdruck und ist für Erkennungsanforderungen bereit.
Name Type Description
Enrolled
  • string
Enrolling
  • string
Training
  • string