---
title: "POST /api/v1/enrollment"
method: POST
path: "/api/v1/enrollment"
tags: ["Enrollment"]
---

# POST /api/v1/enrollment

`POST /api/v1/enrollment`

Este endpoint se utiliza para registrar (enroll) una nueva voz. Recibe uno o varios archivos de audio y devuelve una plantilla de voz (voice template). La plantilla de voz es una cadena que contiene la información biométrica de la voz. Esta plantilla puede utilizarse para autenticar las voces en el futuro.

## Request body

- EnrollmentBody — Cuerpo (body) de la petición de enrollment
  - `audios` AudioBuffer[], required — La longitud del array puede ser 1, o de 3 a 5. No es válido enviar 2 audios, ni más de 5. 1 audio para enrolamiento text-independent. de 3 a 5 audios para enrolamiento text-dependent.
  - `check_liveness` boolean — Si es true, se realizará una prueba de vida (liveness)
  - `check_quality` boolean — Si es true, se realizará una comprobación de calidad
  - `liveness_threshold` number — Umbral para la detección de vida (liveness). Si la probabilidad de vida es inferior a este valor, el audio se considera inválido.
  - `minimum_snr_db` number — SNR mínimo en dB para que el audio se considere válido.
  - `minimum_speech_duration_ms` number — Duración mínima del audio en milisegundos para que se considere válido.
  - `minimum_speech_relative_length` number — Longitud relativa mínima del habla (longitud del habla en relación con la duración total del audio).
  - `maximum_multiple_speakers_detector_score` number — Puntuación máxima permitida del detector de múltiples hablantes.
  - `extra_data` string — Datos tokenizados para invocar al servicio Api Tracking tras la operación, codificados en base64.

## Response `200`

El resultado del enrolamiento de voz. Los campos *_detected solo están presentes cuando falla la comprobación de calidad del audio.

- EnrollmentResponse — Respuesta de enrollment
  - `operation_result` number — Resultado de la operación.
  - `template_type` string — Tipo de plantilla (template) devuelto como resultado de la operación.
  - `template` string — Buffer de la plantilla biométrica (template), obtenido de Enrollment(), cifrado y codificado en base64 RFC4648.
  - `validate_audios_result` AudioResult[]
    - `audio_position` integer — Posición del audio en el vector de audios. Comienza en 0.
    - `result_code` number — Resultado de la operación.
    - `liveness_score` number — Probabilidad de vida (liveness)
    - `matching_score` number — Probabilidad de coincidencia (matching)
    - `snr_db_detected` number — SNR en dB detectado en el audio.
    - `speech_length_ms_detected` number — Duración del habla en milisegundos detectada en el audio.
    - `speech_relative_length_detected` number — Longitud relativa del habla detectada en el audio.
    - `multiple_speakers_score_detected` number — Puntuación de múltiples hablantes detectada en el audio.

## Other responses

- `400` — Han llegado parámetros incorrectos en la petición.
- `500` — Se ha producido un error en la llamada al backend de Voice-SDK.

---

[API](https://skmtc.net/facephi/apis/selphid-sdk-rest-api.md) · [All operations](https://skmtc.net/facephi/apis/selphid-sdk-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/facephi/selphid-sdk-rest-api/revisions/acc985032f98/schema)