Text Dependent - Create Profile

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

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

POST {endpoint}/speaker-recognition/verification/text-dependent/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

TdProfileInfo

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/verification/text-dependent/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",
  "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"
}
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
SpeakerErrorInfo

Talarfelmeddelande
TdProfileInfo

Text-Dependent information om talarprofil
TrainingStatusType

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

  • Registrering: profilen har inget rösttryck och är inte redo för igenkänningsbegäranden.
  • Utbildning: Röstutskrift av profil skapas och kan inte användas för igenkänning just nu.
  • 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.

SpeakerErrorInfo

Talarfelmeddelande

Name Typ Description
error

Error

TdProfileInfo

Text-Dependent information om talarprofil

Name Typ Description
createdDateTime

string

Datumtid för skapande av profil.
enrollmentStatus

TrainingStatusType

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

  • Registrering: profilen har inget rösttryck och är inte redo för igenkänningsbegäranden.
  • Utbildning: Röstutskrift av profil skapas och kan inte användas för igenkänning just nu.
  • 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 att ha tagit bort tystnadssegment och icke-talsegment) i 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).
remainingEnrollmentsCount

integer

Antal registreringsljud som krävs för att slutföra profilregistreringen.

TrainingStatusType

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

  • Registrering: profilen har inget rösttryck och är inte redo för igenkänningsbegäranden.
  • Utbildning: Röstutskrift av profil skapas och kan inte användas för igenkänning just nu.
  • Registrerad: profilen har en röstutskrift och redo för igenkänningsbegäranden.
Name Typ Description
Enrolled

string

Enrolling

string

Training

string