> 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. # Entiteitsdetectie > **Note** > > **Stapsgewijze handleiding** · Hierbij gaan we ervan uit dat je de [Speech to Text- snelstartgids](/docs/nl/eleven-api/guides/cookbooks/speech-to-text) hebt voltooid. ## Overzicht Entiteitsdetectie is een functie waarmee je specifieke woorden en zinnen in het transcript kunt detecteren, inclusief hun exacte tijdstempels. Dit is nuttig voor het detecteren van creditcardnummers, namen, medische aandoeningen of burgerservicenummers, die je vervolgens kunt redigeren. Wanneer deze functie is ingeschakeld, detecteert het model specifieke entiteitstypen in het transcript en levert het de exacte tijdstempels. Bijvoorbeeld: de volgende audio: Geeft het volgende transcript als we `"pii"` (persoonlijk identificeerbare informatie) als entiteitstype opgeven: ```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 } ] } ``` Het resultaat toont de PII-entiteiten die in het transcript zijn gedetecteerd, met hun exacte tijdstempels. ## Entiteitsdetectie integreren Je integreert entiteitsdetectie in de Speech to Text API door de parameter `entity_detection` door te geven aan de methode `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); ``` ## Entiteitstypen De volgende entiteitstypen worden ondersteund voor detectie. Je kunt volledige groepen detecteren met de categoriezoekwoorden `pii`, `phi`, `pci`, `other` of `offensive_language`, of afzonderlijke entiteitstypen opgeven via hun label. Gebruik de categorie `all` om alle entiteitstypen te detecteren. #### PII (persoonlijk identificeerbare informatie) | Label | Beschrijving | Naleving van regelgeving | | --------------------------- | ------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------- | | `account_number` | Identificatienummer van klantaccount of lidmaatschap | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `age` | Getallen die verband houden met de leeftijd van een persoon | GDPR, HIPAA, Quebec Privacy Act, APPI | | `bank_account` | Bankrekeningnummers en internationale equivalenten, zoals IBAN | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `cardinal` | Numerieke uitdrukkingen in hoofdtelwoordvorm | | | `credit_card` | Creditcardnummers | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `credit_card_expiration` | Vervaldatum van een creditcard | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `cvv` | 3- of 4-cijferige kaartverificatiecodes en equivalenten | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `date` | Specifieke kalenderdata, waaronder dagen van de week, datums, maanden of jaren | HIPAA, Quebec Privacy Act | | `date_interval` | Bredere tijdsperioden, waaronder datumbereiken, maanden, seizoenen, jaren en decennia | HIPAA | | `dob` | Geboortedata | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `driver_license` | Rijbewijsnummers | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `email_address` | E-mailadressen | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `event` | Namen van evenementen of feestdagen | | | `filename` | Namen van computerbestanden, inclusief extensie of bestandspad | | | `gender` | Termen die genderidentiteit aanduiden, inclusief slangtermen | CPRA, GDPR, GDPR Sensitive, APPI Sensitive | | `gender_sexuality` | Verouderde alias voor zowel `gender` als `sexual_orientation` | CPRA, GDPR, GDPR Sensitive, APPI Sensitive | | `sexual_orientation` | Termen die seksuele oriëntatie aanduiden, inclusief slangtermen | CPRA, GDPR, GDPR Sensitive, APPI Sensitive | | `healthcare_number` | Zorgnummers en begunstigdenummers van zorgplannen | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `ip_address` | Internet-IP-adressen, inclusief IPv4- en IPv6-indelingen | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `location` | Metaklasse voor elke benoemde locatieverwijzing | GDPR, HIPAA, APPI | | `location_address` | Volledige of gedeeltelijke fysieke postadressen | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `location_city` | Namen van gemeenten, waaronder dorpen, plaatsen en steden | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `location_coordinate` | Geografische posities aangeduid met breedtegraad-, lengtegraad- en/of hoogtecoördinaten | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `location_country` | Landnamen | GDPR, APPI | | `location_state` | Namen van staten, provincies, gebieden of prefecturen | GDPR, APPI | | `location_zip` | ZIP-codes (inclusief ZIP+4), postcodes of postale codes | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `money` | Namen en/of bedragen van valuta | | | `name` | Namen van personen, exclusief persoonlijke titels zoals 'mevrouw' of 'meneer' | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `name_given` | Namen die aan een persoon worden gegeven, meestal bij de geboorte; vaak voor- en tweede namen in westerse culturen | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `name_family` | Namen die iemands familie of gemeenschap aanduiden; vaak een achternaam in westerse culturen | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `name_medical_professional` | Namen inclusief de titel van een medisch professional, zoals "dokter" | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `numerical_pii` | Numerieke PII die niet onder andere categorieën valt | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `occupation` | Functietitels of beroepen | Quebec Privacy Act, APPI | | `ordinal` | Numerieke uitdrukkingen in rangtelwoordvorm | | | `origin` | Termen die nationaliteit, etniciteit of herkomst aanduiden | CPRA, GDPR, GDPR Sensitive, Quebec Privacy Act, APPI Sensitive | | `passport_number` | Paspoortnummers, uitgegeven door elk land | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `password` | Accountwachtwoorden, pincode, toegangssleutels of verificatieantwoorden | CPRA, APPI | | `percent` | Numerieke uitdrukkingen als percentages | | | `phone_number` | Telefoon- of faxnummers | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `physical_attribute` | Kenmerkende lichamelijke eigenschappen, waaronder termen die ras aanduiden | CPRA, GDPR, GDPR Sensitive, APPI Sensitive | | `ssn` | Social Security Numbers of internationale equivalente identificatienummers van de overheid | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `time` | Uitdrukkingen die kloktijden aanduiden | | | `url` | Internetadressen | CPRA, GDPR, HIPAA, Quebec Privacy Act | | `username` | Gebruikersnamen, inlognamen of handles | CPRA, GDPR, APPI | | `vehicle_id` | Voertuigidentificatienummers (VIN's), serienummers van voertuigen en kentekennummers | CPRA, GDPR, HIPAA, APPI | #### PHI (beschermde gezondheidsinformatie) | Label | Beschrijving | Naleving van regelgeving | | ---------------------- | ------------------------------------------------------------------------------- | ----------------------------------------------------- | | `condition` | Namen van medische aandoeningen, ziekten, syndromen, beperkingen en stoornissen | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI Sensitive | | `drug` | Medicijnen, vitaminen en supplementen | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI Sensitive | | `injury` | Lichamelijk letsel, waaronder mutaties, miskramen en ontwrichtingen | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI Sensitive | | `blood_type` | Bloedgroepen | CPRA, GDPR, HIPAA, Quebec Privacy Act | | `medical_process` | Medische processen, waaronder behandelingen, procedures en tests | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI Sensitive | | `clinical_measurement` | Klinische metingen, vitale waarden en laboratoriumresultaten | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI Sensitive | | `statistics` | Verouderde alias voor `clinical_measurement` | HIPAA, Quebec Privacy Act | #### PCI (Payment Card Industry) | Label | Beschrijving | Naleving van regelgeving | | ------------------------ | ------------------------------------------------------- | ------------------------------------------- | | `credit_card` | Creditcardnummers | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `credit_card_expiration` | Vervaldatum van een creditcard | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `cvv` | 3- of 4-cijferige kaartverificatiecodes en equivalenten | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | #### Andere entiteiten | Label | Beschrijving | Naleving van regelgeving | | ----------------------- | --------------------------------------------------------------------- | -------------------------------------------------------------- | | `language` | Namen van natuurlijke talen | GDPR, GDPR Sensitive, APPI Sensitive | | `marital_status` | Termen die burgerlijke staat aanduiden | APPI Sensitive | | `organization` | Namen van organisaties of afdelingen binnen een organisatie | Quebec Privacy Act, APPI | | `political_affiliation` | Termen die verwijzen naar een politieke partij, beweging of ideologie | CPRA, GDPR, GDPR Sensitive, Quebec Privacy Act, APPI Sensitive | | `religion` | Termen die religieuze verbondenheid aanduiden | CPRA, GDPR, GDPR Sensitive, Quebec Privacy Act, APPI Sensitive | | `routing_number` | Routingnummer gekoppeld aan een bank of financiële instelling | | | `zodiac_sign` | Namen van sterrenbeelden | | | `product_or_service` | Namen van commerciële producten of diensten | | | `food_or_beverage` | Namen van voedsel, dranken en gerechten | | | `document_reference` | Verwijzingen naar documenten, zaaknummers of bestands-ID's | | | `generic_id` | Algemene identificatoren die niet onder andere ID-categorieën vallen | | | `measurement` | Fysieke metingen en hoeveelheden met eenheden | | | `time_duration` | Uitdrukkingen die een tijdsduur of -spanne aanduiden | | #### Aanstootgevende taal | Label | Beschrijving | Naleving van regelgeving | | ------------------------- | -------------------------------------------------- | ------------------------ | | `very_offensive_language` | Zeer aanstootgevende taal, waaronder scheldwoorden | | | `less_offensive_language` | Licht aanstootgevende of ongepaste taal | | ## Entiteiten redigeren Naast het detecteren van entiteiten kun je ze met de parameter `entity_redaction` uit de transcripttekst redigeren. Deze accepteert dezelfde indeling als `entity_detection`: `all`, een categoriezoekwoord of een lijst met specifieke entiteitstypen. De geredigeerde typen moeten een subset zijn van de gedetecteerde typen. Wanneer redigeren is ingeschakeld, wordt overeenkomende entiteitstekst vervangen door een markering in zowel de transcripttekst als de uitvoer op woordniveau, en wordt het veld `entities` niet geretourneerd in het antwoord. ```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." ``` De parameter `entity_redaction_mode` bepaalt de indeling van de markering: | Modus | Markering | Voorbeeld | | ------------------------ | ------------------------------------------ | ------------------------- | | `redacted` | `{REDACTED}` voor elke entiteit | `Hi {REDACTED}` | | `entity_type` | Het entiteitstype tussen accolades | `Hi {NAME}` | | `enumerated_entity_type` | Het entiteitstype plus een voorkomenteller | `Hi {NAME_0}` (standaard) | > **Warning** > > Entiteitsdetectie en -redactie worden niet ondersteund met de `combined`-uitvoerstijl voor meerdere kanalen. ## Volgende stappen #### [API-referentie](/docs/nl/api-reference/speech-to-text) Volledige API-referentie en parameters voor Speech to Text. #### [Transcriptie voor meerdere kanalen](/docs/nl/eleven-api/guides/how-to/speech-to-text/batch/multichannel-transcription) Transcribeer audio met meerdere kanalen met sprekerstoewijzing per kanaal.