Text Independent - Create Profile

Service:

Speaker Recognition

API Version:

2021-09-05

Crear perfil
Crea un nuevo perfil de hablante con la configuración regional especificada.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
endpoint	path	True	string	Puntos de conexión de Cognitive Services admitidos (protocolo y nombre de host, por ejemplo: https://westus.api.cognitive.microsoft.com).
api-version	query	True	string	Especifica la versión de la operación que se utiliza para esta solicitud.

Encabezado de la solicitud

Nombre	Requerido	Tipo	Description
Ocp-Apim-Subscription-Key	True	string

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
locale	True	string	Identificador de idioma que consta de una combinación de código de idioma y código de país.

Respuestas

Nombre	Tipo	Description
201 Created	TiProfileInfo	El perfil del hablante se creó correctamente. Se devuelve el GUID para hacer referencia al perfil creado. Headers location: string
Other Status Codes	SpeakerErrorInfo	Error Headers x-ms-error-code: string

Seguridad

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Ejemplos

Successful Query

Sample Request

HTTP

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"
  }
}

Definiciones

Nombre	Description
Error
LocaleInfo	Configuración regional del perfil del hablante
ProfileStatusType	Estado que representa el estado actual de la activación del perfil. Valores disponibles: Activo: el perfil está activo y se puede usar si el estado de inscripción es "Inscrito". Inactivo: el perfil no se ha activado y se debe enviar una frase de activación.
SpeakerErrorInfo	Mensaje de error del hablante
TiProfileInfo	Text-Independent información del perfil de Speaker
TrainingStatusType	Estado que representa el estado actual de la inscripción del perfil. Valores disponibles: Inscripción: el perfil no tiene impresión de voz y no está listo para las solicitudes de reconocimiento. Entrenamiento: se está creando la impresión de voz del perfil y no se puede usar para el reconocimiento en este momento. Inscrito: el perfil tiene una impresión de voz y está lista para las solicitudes de reconocimiento.

Error

Nombre	Tipo	Description
code	string
message	string

LocaleInfo

Configuración regional del perfil del hablante

Nombre	Tipo	Description
locale	string	Identificador de idioma que consta de una combinación de código de idioma y código de país.

ProfileStatusType

Estado que representa el estado actual de la activación del perfil. Valores disponibles:

• Activo: el perfil está activo y se puede usar si el estado de inscripción es "Inscrito".
• Inactivo: el perfil no se ha activado y se debe enviar una frase de activación.

Nombre	Tipo	Description
Active	string
Inactive	string

SpeakerErrorInfo

Mensaje de error del hablante

Nombre	Tipo	Description
error	Error

TiProfileInfo

Text-Independent información del perfil de Speaker

Nombre	Tipo	Description
createdDateTime	string	Fecha y hora de creación del perfil.
enrollmentStatus	TrainingStatusType	Estado que representa el estado actual de la inscripción del perfil. Valores disponibles: Inscripción: el perfil no tiene impresión de voz y no está listo para las solicitudes de reconocimiento. Entrenamiento: se está creando la impresión de voz del perfil y no se puede usar para el reconocimiento en este momento. Inscrito: el perfil tiene una impresión de voz y está lista para las solicitudes de reconocimiento.
enrollmentsCount	integer	Número de audios de inscripción aceptados para este perfil.
enrollmentsLengthInSec	number	Longitud total de los audios de inscripción aceptados para este perfil en segundos.
enrollmentsSpeechLengthInSec	number	Suma de voz pura (que es la cantidad de audio después de quitar el silencio y los segmentos que no son de voz) en todas las inscripciones de perfil en segundos.
lastUpdatedDateTime	string	Última fecha y hora en que se actualizó el perfil.
locale	string	Identificador de idioma que consta de una combinación de código de idioma y código de país.
modelVersion	string	Fecha en la que se especifica el modelo asignado a este perfil. El formato es aaaa-mm-dd. Si el perfil no tiene inscripciones, este valor estará vacío.
profileId	string	Identificador único del identificador de perfil (GUID).
profileStatus	ProfileStatusType	Estado que representa el estado actual de la activación del perfil. Valores disponibles: Activo: el perfil está activo y se puede usar si el estado de inscripción es "Inscrito". Inactivo: el perfil no se ha activado y se debe enviar una frase de activación.
remainingEnrollmentsSpeechLengthInSec	number	Cantidad de voz pura (que es la cantidad de audio después de quitar el silencio y los segmentos que no son de voz) necesarios para completar la inscripción de perfiles en segundos.

TrainingStatusType

Estado que representa el estado actual de la inscripción del perfil. Valores disponibles:

• Inscripción: el perfil no tiene impresión de voz y no está listo para las solicitudes de reconocimiento.
• Entrenamiento: se está creando la impresión de voz del perfil y no se puede usar para el reconocimiento en este momento.
• Inscrito: el perfil tiene una impresión de voz y está lista para las solicitudes de reconocimiento.

Nombre	Tipo	Description
Enrolled	string
Enrolling	string
Training	string