> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # Detección de entidades > **Note** > > **Guía práctica** · Da por hecho que has completado la [guía de inicio rápido de Voz a Texto ](/docs/es/eleven-api/guides/cookbooks/speech-to-text). ## Descripción general La detección de entidades es una función que te permite detectar palabras y frases específicas en la transcripción, proporcionando sus marcas de tiempo exactas. Resulta útil para detectar números de tarjetas de crédito, nombres, condiciones médicas o números de la Seguridad Social que luego pueden ocultarse. Cuando está activada, el modelo detectará tipos de entidades específicos en la transcripción y proporcionará sus marcas de tiempo exactas. Por ejemplo, el siguiente audio: Genera la siguiente transcripción cuando especificamos `"pii"` (información de identificación personal) como tipo de entidad: ```json maxLines=0 { "language_code": "eng", "language_probability": 0.9869821071624756, "text": "My name is Jill. My date of birth is the 12th of July 1987, and my credit card number is 4242-4242-4242-4242.", "words": [ { "text": "My", "start": 0.099, "end": 0.259, "type": "word", "logprob": 0.0 }, { "text": " ", "start": 0.259, "end": 0.299, "type": "spacing", "logprob": 0.0 }, { "text": "name", "start": 0.299, "end": 0.42, "type": "word", "logprob": 0.0 }, ... ], "transcription_id": "Y2ZX8AxHUzTPCIualYiE", "entities": [ { "text": "Jill", "entity_type": "name", "start_char": 11, "end_char": 15 }, { "text": "12th of July 1987", "entity_type": "dob", "start_char": 41, "end_char": 58 }, { "text": "4242-4242-4242-4242", "entity_type": "credit_card", "start_char": 89, "end_char": 108 } ] } ``` El resultado muestra las entidades de información de identificación personal detectadas en la transcripción, con sus marcas de tiempo exactas. ## Integración de la detección de entidades La detección de entidades se integra en la API de Voz a Texto pasando el parámetro `entity_detection` al método `convert`. ```python maxLines=0 import os from dotenv import load_dotenv from io import BytesIO import requests from elevenlabs.client import ElevenLabs load_dotenv() elevenlabs = ElevenLabs( api_key=os.getenv("ELEVENLABS_API_KEY"), ) audio_url = ( "https://storage.googleapis.com/eleven-public-cdn/documentation_assets/audio/stt-entity-detection-pii.mp3" ) response = requests.get(audio_url) audio_data = BytesIO(response.content) transcription = elevenlabs.speech_to_text.convert( file=audio_data, model_id="scribe_v2", # Model to use # Entity types to detect, accepts a list of specific entity types or categories. # To detect all entity types, use the "all" category. entity_detection=["pii"], ) print("Entities detected:", transcription.entities) ``` ```typescript maxLines=0 import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js"; import "dotenv/config"; const elevenlabs = new ElevenLabsClient({ apiKey: process.env.ELEVENLABS_API_KEY, }); const response = await fetch( "https://storage.googleapis.com/eleven-public-cdn/documentation_assets/audio/stt-entity-detection-pii.mp3" ); const audioBlob = new Blob([await response.arrayBuffer()], { type: "audio/mp3" }); const transcription = await elevenlabs.speechToText.convert({ file: audioBlob, modelId: "scribe_v2", // Model to use // Entity types to detect, accepts a list of specific entity types or categories. // To detect all entity types, use the "all" category. entityDetection: ["pii"], }); console.log("Entities detected:", transcription.entities); ``` ## Tipos de entidades Se pueden detectar los siguientes tipos de entidades. Puedes detectar grupos completos usando las palabras clave de categoría `pii`, `phi`, `pci`, `other` u `offensive_language`, o especificar tipos de entidad individuales mediante su etiqueta. Para detectar todos los tipos de entidad, usa la categoría `all`. #### PII (información de identificación personal) | Etiqueta | Descripción | Cumplimiento normativo | | --------------------------- | -------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | | `account_number` | Número de identificación de cuenta de cliente o afiliación | CPRA, RGPD, HIPAA, Ley de Protección de la Privacidad de Quebec, APPI | | `age` | Números asociados a la edad de una persona | RGPD, HIPAA, Ley de Protección de la Privacidad de Quebec, APPI | | `bank_account` | Números de cuentas bancarias y equivalentes internacionales, como el IBAN | CPRA, RGPD, HIPAA, Ley de Protección de la Privacidad de Quebec, APPI | | `cardinal` | Expresiones numéricas en forma cardinal | | | `credit_card` | Números de tarjetas de crédito | CPRA, RGPD, HIPAA, Ley de Protección de la Privacidad de Quebec, APPI | | `credit_card_expiration` | Fecha de caducidad de una tarjeta de crédito | CPRA, RGPD, HIPAA, Ley de Protección de la Privacidad de Quebec, APPI | | `cvv` | Códigos de verificación de tarjeta de 3 o 4 dígitos y equivalentes | CPRA, RGPD, HIPAA, Ley de Protección de la Privacidad de Quebec, APPI | | `date` | Fechas concretas del calendario, que pueden incluir días de la semana, fechas, meses o años | HIPAA, Ley de Protección de la Privacidad de Quebec | | `date_interval` | Períodos más amplios, incluidos intervalos de fechas, meses, estaciones, años y décadas | HIPAA | | `dob` | Fechas de nacimiento | CPRA, RGPD, HIPAA, Ley de Protección de la Privacidad de Quebec, APPI | | `driver_license` | Números de permisos de conducir | CPRA, RGPD, HIPAA, Ley de Protección de la Privacidad de Quebec, APPI | | `email_address` | Direcciones de correo electrónico | CPRA, RGPD, HIPAA, Ley de Protección de la Privacidad de Quebec, APPI | | `event` | Nombres de eventos o festividades | | | `filename` | Nombres de archivos informáticos, incluida la extensión o la ruta del archivo | | | `gender` | Términos que indican identidad de género, incluidos términos coloquiales | CPRA, RGPD, RGPD sensible, APPI sensible | | `gender_sexuality` | Alias heredado que abarca tanto `gender` como `sexual_orientation` | CPRA, RGPD, RGPD sensible, APPI sensible | | `sexual_orientation` | Términos que indican orientación sexual, incluidos términos coloquiales | CPRA, RGPD, RGPD sensible, APPI sensible | | `healthcare_number` | Números sanitarios y números de beneficiario de planes de salud | CPRA, RGPD, HIPAA, Ley de Protección de la Privacidad de Quebec, APPI | | `ip_address` | Dirección IP de Internet, incluidos los formatos IPv4 e IPv6 | CPRA, RGPD, HIPAA, Ley de Protección de la Privacidad de Quebec, APPI | | `location` | Metaclase para cualquier referencia de ubicación con nombre | RGPD, HIPAA, APPI | | `location_address` | Direcciones postales físicas completas o parciales | CPRA, RGPD, HIPAA, Ley de Protección de la Privacidad de Quebec, APPI | | `location_city` | Nombres de municipios, incluidos pueblos, localidades y ciudades | CPRA, RGPD, HIPAA, Ley de Protección de la Privacidad de Quebec, APPI | | `location_coordinate` | Posiciones geográficas indicadas mediante coordenadas de latitud, longitud o elevación | CPRA, RGPD, HIPAA, Ley de Protección de la Privacidad de Quebec, APPI | | `location_country` | Nombres de países | RGPD, APPI | | `location_state` | Nombres de estados, provincias, territorios o prefecturas | RGPD, APPI | | `location_zip` | Códigos ZIP (incluido ZIP+4), códigos postales u otros códigos de correo | CPRA, RGPD, HIPAA, Ley de Protección de la Privacidad de Quebec, APPI | | `money` | Nombres o importes de divisas | | | `name` | Nombres de personas, sin incluir títulos personales como «Sra.» o «Sr.» | CPRA, RGPD, HIPAA, Ley de Protección de la Privacidad de Quebec, APPI | | `name_given` | Nombres dados a una persona, normalmente al nacer; suelen ser nombre y segundo nombre en culturas occidentales | CPRA, RGPD, HIPAA, Ley de Protección de la Privacidad de Quebec, APPI | | `name_family` | Nombres que indican la familia o comunidad de una persona; suelen ser apellidos en culturas occidentales | CPRA, RGPD, HIPAA, Ley de Protección de la Privacidad de Quebec, APPI | | `name_medical_professional` | Nombres que incluyen el título de un profesional sanitario, como «Doctor» | CPRA, RGPD, HIPAA, Ley de Protección de la Privacidad de Quebec, APPI | | `numerical_pii` | PII numérica que no entra en otras categorías | CPRA, RGPD, HIPAA, Ley de Protección de la Privacidad de Quebec, APPI | | `occupation` | Puestos de trabajo o profesiones | Ley de Protección de la Privacidad de Quebec, APPI | | `ordinal` | Expresiones numéricas en forma ordinal | | | `origin` | Términos que indican nacionalidad, etnia o procedencia | CPRA, RGPD, RGPD sensible, Ley de Protección de la Privacidad de Quebec, APPI sensible | | `passport_number` | Números de pasaporte emitidos por cualquier país | CPRA, RGPD, HIPAA, Ley de Protección de la Privacidad de Quebec, APPI | | `password` | Contraseñas de cuentas, PIN, claves de acceso o respuestas de verificación | CPRA, APPI | | `percent` | Expresiones numéricas en forma de porcentajes | | | `phone_number` | Números de teléfono o fax | CPRA, RGPD, HIPAA, Ley de Protección de la Privacidad de Quebec, APPI | | `physical_attribute` | Atributos físicos distintivos, incluidos términos que indican raza | CPRA, RGPD, RGPD sensible, APPI sensible | | `ssn` | Números de la Seguridad Social o números de identificación gubernamental equivalentes internacionales | CPRA, RGPD, HIPAA, Ley de Protección de la Privacidad de Quebec, APPI | | `time` | Expresiones que indican horas | | | `url` | Direcciones de Internet | CPRA, RGPD, HIPAA, Ley de Protección de la Privacidad de Quebec | | `username` | Nombres de usuario, nombres de inicio de sesión o alias | CPRA, RGPD, APPI | | `vehicle_id` | Números de identificación de vehículos (VIN), números de serie de vehículos y matrículas | CPRA, RGPD, HIPAA, APPI | #### PHI (información sanitaria protegida) | Etiqueta | Descripción | Cumplimiento normativo | | ---------------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------ | | `condition` | Nombres de afecciones médicas, enfermedades, síndromes, déficits y trastornos | CPRA, RGPD, HIPAA, Ley de Protección de la Privacidad de Quebec, APPI sensible | | `drug` | Medicamentos, vitaminas y suplementos | CPRA, RGPD, HIPAA, Ley de Protección de la Privacidad de Quebec, APPI sensible | | `injury` | Lesiones físicas, incluidas mutaciones, abortos espontáneos y dislocaciones | CPRA, RGPD, HIPAA, Ley de Protección de la Privacidad de Quebec, APPI sensible | | `blood_type` | Grupos sanguíneos | CPRA, RGPD, HIPAA, Ley de Protección de la Privacidad de Quebec | | `medical_process` | Procesos médicos, incluidos tratamientos, procedimientos y pruebas | CPRA, RGPD, HIPAA, Ley de Protección de la Privacidad de Quebec, APPI sensible | | `clinical_measurement` | Mediciones clínicas, constantes vitales y resultados de laboratorio | CPRA, RGPD, HIPAA, Ley de Protección de la Privacidad de Quebec, APPI sensible | | `statistics` | Alias heredado para `clinical_measurement` | HIPAA, Ley de Protección de la Privacidad de Quebec | #### PCI (sector de tarjetas de pago) | Etiqueta | Descripción | Cumplimiento normativo | | ------------------------ | ------------------------------------------------------------------ | --------------------------------------------------------------------- | | `credit_card` | Números de tarjetas de crédito | CPRA, RGPD, HIPAA, Ley de Protección de la Privacidad de Quebec, APPI | | `credit_card_expiration` | Fecha de caducidad de una tarjeta de crédito | CPRA, RGPD, HIPAA, Ley de Protección de la Privacidad de Quebec, APPI | | `cvv` | Códigos de verificación de tarjeta de 3 o 4 dígitos y equivalentes | CPRA, RGPD, HIPAA, Ley de Protección de la Privacidad de Quebec, APPI | #### Otras entidades | Etiqueta | Descripción | Cumplimiento normativo | | ----------------------- | --------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | | `language` | Nombres de lenguas naturales | RGPD, RGPD sensible, APPI sensible | | `marital_status` | Términos que indican estado civil | APPI sensible | | `organization` | Nombres de organizaciones o departamentos dentro de una organización | Ley de Protección de la Privacidad de Quebec, APPI | | `political_affiliation` | Términos que hacen referencia a un partido político, movimiento o ideología | CPRA, RGPD, RGPD sensible, Ley de Protección de la Privacidad de Quebec, APPI sensible | | `religion` | Términos que indican afiliación religiosa | CPRA, RGPD, RGPD sensible, Ley de Protección de la Privacidad de Quebec, APPI sensible | | `routing_number` | Número de ruta asociado a un banco o institución financiera | | | `zodiac_sign` | Nombres de signos del zodiaco | | | `product_or_service` | Nombres de productos o servicios comerciales | | | `food_or_beverage` | Nombres de alimentos, bebidas y platos | | | `document_reference` | Referencias a documentos, números de caso o identificadores de archivos | | | `generic_id` | Identificadores genéricos que no entran en otras categorías de ID | | | `measurement` | Mediciones físicas y cantidades con unidades | | | `time_duration` | Expresiones que indican una duración o período de tiempo | | #### Lenguaje ofensivo | Etiqueta | Descripción | Cumplimiento normativo | | ------------------------- | ------------------------------------------- | ---------------------- | | `very_offensive_language` | Lenguaje muy ofensivo, incluidos insultos | | | `less_offensive_language` | Lenguaje ligeramente ofensivo o inapropiado | | ## Redacción de entidades Además de detectar entidades, puedes ocultarlas en el texto de la transcripción con el parámetro `entity_redaction`. Acepta el mismo formato que `entity_detection`: `all`, una palabra clave de categoría o una lista de tipos de entidad específicos. Los tipos ocultados deben ser un subconjunto de los tipos detectados. Cuando la redacción está activada, el texto de las entidades coincidentes se sustituye por un marcador tanto en el texto de la transcripción como en la salida a nivel de palabra, y el campo `entities` no se devuelve en la respuesta. ```python transcription = elevenlabs.speech_to_text.convert( file=audio_file, model_id="scribe_v2", entity_detection=["pii"], entity_redaction=["pii"], entity_redaction_mode="enumerated_entity_type", ) print(transcription.text) # "Hi {NAME_0}, your card ending in {CREDIT_CARD_0} was declined." ``` ```typescript const transcription = await elevenlabs.speechToText.convert({ file: audioBlob, modelId: "scribe_v2", entityDetection: ["pii"], entityRedaction: ["pii"], entityRedactionMode: "enumerated_entity_type", }); console.log(transcription.text); // "Hi {NAME_0}, your card ending in {CREDIT_CARD_0} was declined." ``` El parámetro `entity_redaction_mode` controla el formato del marcador: | Modo | Marcador | Ejemplo | | ------------------------ | ------------------------------------------------- | ------------------------------ | | `redacted` | `{REDACTED}` para cada entidad | `Hi {REDACTED}` | | `entity_type` | El tipo de entidad entre llaves | `Hi {NAME}` | | `enumerated_entity_type` | El tipo de entidad más un contador de apariciones | `Hi {NAME_0}` (predeterminado) | > **Warning** > > La detección y redacción de entidades no son compatibles con el estilo de salida multicanal `combined`. ## Próximos pasos #### [Referencia de la API](/docs/es/api-reference/speech-to-text) Referencia y parámetros completos de la API de Voz a Texto. #### [Transcripción multicanal](/docs/es/eleven-api/guides/how-to/speech-to-text/batch/multichannel-transcription) Transcribe audio multicanal con atribución de hablante por canal.