Text Independent - Create Profile

  • Referens
Service:
Speaker Recognition
API Version:
2021-09-05

Skapa profil
Skapar en ny talarprofil med angivet språk.

POST {endpoint}/speaker-recognition/identification/text-independent/profiles?api-version=2021-09-05

URI-parametrar

Name I Obligatorisk Typ Description
endpoint
 path True

string

Cognitive Services-slutpunkter som stöds (protokoll och värdnamn, till exempel: https://westus.api.cognitive.microsoft.com).
api-version
 query True

string

Anger vilken version av åtgärden som ska användas för den här begäran.

Begärandehuvud

Name Obligatorisk Typ Description
Ocp-Apim-Subscription-Key True

string

Begärandetext

Name Obligatorisk Typ Description
locale True

string

Språkidentifierare som består av en kombination av språkkod och landskod.

Svar

Name Typ Description
201 Created

TiProfileInfo

Talarprofilen har skapats. GUID returneras för att referera till den skapade profilen.

Headers

location: string
Other Status Codes

SpeakerErrorInfo

Fel

Headers

x-ms-error-code: string

Säkerhet

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Exempel

Successful Query

Sample Request

POST https://westus.api.cognitive.microsoft.com/speaker-recognition/identification/text-independent/profiles?api-version=2021-09-05


{
  "locale": "en-us"
}

Sample Response

Status code:
201 
Content-Type: application/json
Response Body
{
  "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"
}
Status code:
default 
Content-Type: application/json
x-ms-error-code: Error Code
Response Body
{
  "error": {
    "code": "Error Code",
    "message": "Erro Messae"
  }
}

Definitioner

Name Description
Error
LocaleInfo

Språkvariant för talarprofil
ProfileStatusType

Status som representerar det aktuella tillståndet för profilaktiveringen. Tillgängliga värden är:

  • Aktiv: profilen är aktiv och kan användas om registreringsstatusen är "Registrerad".
  • Inaktiv: profilen har inte aktiverats och en aktiveringsfras måste skickas.
SpeakerErrorInfo

Talarfelmeddelande
TiProfileInfo

Text-Independent information om talarprofil
TrainingStatusType

Status som representerar profilregistreringens aktuella tillstånd. Tillgängliga värden är:

  • Registrering: profilen har inget röstuttryck och är inte redo för igenkänningsförfrågningar.
  • Utbildning: Röstutskrift av profilen skapas och kan inte användas för igenkänning för tillfället.
  • Registrerad: profilen har en röstutskrift och redo för igenkänningsbegäranden.

Error

Name Typ Description
code

string

message

string

LocaleInfo

Språkvariant för talarprofil

Name Typ Description
locale

string

Språkidentifierare som består av en kombination av språkkod och landskod.

ProfileStatusType

Status som representerar det aktuella tillståndet för profilaktiveringen. Tillgängliga värden är:

  • Aktiv: profilen är aktiv och kan användas om registreringsstatusen är "Registrerad".
  • Inaktiv: profilen har inte aktiverats och en aktiveringsfras måste skickas.
Name Typ Description
Active

string

Inactive

string

SpeakerErrorInfo

Talarfelmeddelande

Name Typ Description
error

Error

TiProfileInfo

Text-Independent information om talarprofil

Name Typ Description
createdDateTime

string

Datetime för skapande av profil.
enrollmentStatus

TrainingStatusType

Status som representerar profilregistreringens aktuella tillstånd. Tillgängliga värden är:

  • Registrering: profilen har inget röstuttryck och är inte redo för igenkänningsförfrågningar.
  • Utbildning: Röstutskrift av profilen skapas och kan inte användas för igenkänning för tillfället.
  • Registrerad: profilen har en röstutskrift och redo för igenkänningsbegäranden.
enrollmentsCount

integer

Antal registreringsljud som godkänts för den här profilen.
enrollmentsLengthInSec

number

Total längd på registreringsljud som godkänts för den här profilen på några sekunder.
enrollmentsSpeechLengthInSec

number

Sammanfattning av rent tal (vilket är mängden ljud efter borttagning av tystnad och icke-talsegment) för alla profilregistreringar på några sekunder.
lastUpdatedDateTime

string

Senaste datetime när profilen uppdaterades.
locale

string

Språkidentifierare som består av en kombination av språkkod och landskod.
modelVersion

string

Datum då modellen som tilldelats den här profilen anges. Formatet är åååå-mm-dd. Om profilen inte har några registreringar är det här värdet tomt.
profileId

string

Unik identifierare för profil-ID (GUID).
profileStatus

ProfileStatusType

Status som representerar det aktuella tillståndet för profilaktiveringen. Tillgängliga värden är:

  • Aktiv: profilen är aktiv och kan användas om registreringsstatusen är "Registrerad".
  • Inaktiv: profilen har inte aktiverats och en aktiveringsfras måste skickas.
remainingEnrollmentsSpeechLengthInSec

number

Mängden rent tal (vilket är mängden ljud efter borttagning av tystnad och icke-talsegment) som behövs för att slutföra profilregistreringen på några sekunder.

TrainingStatusType

Status som representerar profilregistreringens aktuella tillstånd. Tillgängliga värden är:

  • Registrering: profilen har inget röstuttryck och är inte redo för igenkänningsförfrågningar.
  • Utbildning: Röstutskrift av profilen skapas och kan inte användas för igenkänning för tillfället.
  • Registrerad: profilen har en röstutskrift och redo för igenkänningsbegäranden.
Name Typ Description
Enrolled

string

Enrolling

string

Training

string