> 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. # Entitätserkennung > **Note** > > **Anleitung** · Setzt voraus, dass Sie den [Speech to Text Schnellstart](/docs/de/eleven-api/guides/cookbooks/speech-to-text) abgeschlossen haben. ## Überblick Die Entitätserkennung ermöglicht es Ihnen, bestimmte Wörter und Phrasen im Transkript zu erkennen und ihre exakten Zeitstempel bereitzustellen. Das ist nützlich, um Kreditkartennummern, Namen, medizinische Diagnosen oder Sozialversicherungsnummern zu erkennen, die anschließend geschwärzt werden können. Wenn sie aktiviert ist, erkennt das Modell bestimmte Entitätstypen im Transkript und liefert ihre exakten Zeitstempel. Zum Beispiel erzeugt das folgende Audio: Folgendes Transkript, wenn wir `"pii"` (personenbezogene Daten) als Entitätstyp angeben: ```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 } ] } ``` Das Ergebnis zeigt die im Transkript erkannten PII-Entitäten mit ihren exakten Zeitstempeln. ## Entitätserkennung integrieren Die Entitätserkennung wird in die Speech to Text API integriert, indem Sie den Parameter `entity_detection` an die Methode `convert` übergeben. ```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); ``` ## Entitätstypen Die folgenden Entitätstypen werden für die Erkennung unterstützt. Sie können ganze Gruppen mit den Kategorie-Schlüsselwörtern `pii`, `phi`, `pci`, `other` oder `offensive_language` erkennen oder einzelne Entitätstypen über ihr Label angeben. Um alle Entitätstypen zu erkennen, verwenden Sie die Kategorie `all`. #### PII (personenbezogene Daten) | Label | Beschreibung | Einhaltung gesetzlicher Vorschriften | | --------------------------- | --------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- | | `account_number` | Kundenkonto- oder Mitgliedsidentifikationsnummer | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `age` | Zahlen, die mit dem Alter einer Person verbunden sind | GDPR, HIPAA, Quebec Privacy Act, APPI | | `bank_account` | Bankkontonummern und internationale Entsprechungen wie IBAN | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `cardinal` | Numerische Ausdrücke in Kardinalform | | | `credit_card` | Kreditkartennummern | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `credit_card_expiration` | Ablaufdatum einer Kreditkarte | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `cvv` | Drei- oder vierstellige Kartenprüfcodes und Entsprechungen | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `date` | Bestimmte Kalenderdaten, einschließlich Wochentagen, Daten, Monaten oder Jahren | HIPAA, Quebec Privacy Act | | `date_interval` | Größere Zeiträume, einschließlich Datumsbereichen, Monaten, Jahreszeiten, Jahren und Jahrzehnten | HIPAA | | `dob` | Geburtsdaten | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `driver_license` | Führerscheinnummern | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `email_address` | E-Mail-Adressen | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `event` | Namen von Veranstaltungen oder Feiertagen | | | `filename` | Namen von Computerdateien, einschließlich Erweiterung oder Dateipfad | | | `gender` | Begriffe zur Geschlechtsidentität, einschließlich Umgangssprache | CPRA, GDPR, GDPR Sensitive, APPI Sensitive | | `gender_sexuality` | Veralteter Alias, der sowohl `gender` als auch `sexual_orientation` abdeckt | CPRA, GDPR, GDPR Sensitive, APPI Sensitive | | `sexual_orientation` | Begriffe zur sexuellen Orientierung, einschließlich Umgangssprache | CPRA, GDPR, GDPR Sensitive, APPI Sensitive | | `healthcare_number` | Krankenversicherungsnummern und Nummern von Leistungsempfängern eines Gesundheitsplans | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `ip_address` | Internet-IP-Adresse, einschließlich IPv4- und IPv6-Formaten | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `location` | Metaklasse für jeden Verweis auf einen benannten Ort | GDPR, HIPAA, APPI | | `location_address` | Vollständige oder teilweise physische Postadressen | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `location_city` | Namen von Gemeinden, einschließlich Dörfern, Kleinstädten und Städten | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `location_coordinate` | Geografische Positionen, angegeben über Breiten-, Längen- und/oder Höhenkoordinaten | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `location_country` | Ländernamen | GDPR, APPI | | `location_state` | Namen von Bundesstaaten, Provinzen, Territorien oder Präfekturen | GDPR, APPI | | `location_zip` | ZIP-Codes (einschließlich ZIP+4), Postleitzahlen oder postalische Codes | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `money` | Namen und/oder Beträge von Währungen | | | `name` | Namen von Personen, ohne persönliche Anreden wie „Frau“ oder „Herr“ | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `name_given` | Einer Person, meist bei der Geburt, gegebene Namen; in westlichen Kulturen oft Vor- oder Zweitnamen | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `name_family` | Namen, die die Familie oder Gemeinschaft einer Person angeben; in westlichen Kulturen oft Nachnamen | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `name_medical_professional` | Namen einschließlich der Berufsbezeichnung einer medizinischen Fachkraft wie „Doktor“ | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `numerical_pii` | Numerische PII, die nicht unter andere Kategorien fällt | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `occupation` | Berufsbezeichnungen oder Berufe | Quebec Privacy Act, APPI | | `ordinal` | Numerische Ausdrücke in Ordinalform | | | `origin` | Begriffe für Nationalität, ethnische Zugehörigkeit oder Herkunft | CPRA, GDPR, GDPR Sensitive, Quebec Privacy Act, APPI Sensitive | | `passport_number` | Von einem beliebigen Land ausgestellte Reisepassnummern | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `password` | Kontopasswörter, PINs, Zugangsschlüssel oder Verifizierungsantworten | CPRA, APPI | | `percent` | Numerische Ausdrücke als Prozentsätze | | | `phone_number` | Telefon- oder Faxnummern | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `physical_attribute` | Auffällige körperliche Merkmale, einschließlich Begriffen zur ethnischen Zugehörigkeit | CPRA, GDPR, GDPR Sensitive, APPI Sensitive | | `ssn` | Sozialversicherungsnummern oder entsprechende staatliche Identifikationsnummern im Ausland | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `time` | Ausdrücke für Uhrzeiten | | | `url` | Internetadressen | CPRA, GDPR, HIPAA, Quebec Privacy Act | | `username` | Benutzernamen, Anmeldenamen oder Handles | CPRA, GDPR, APPI | | `vehicle_id` | Fahrzeugidentifikationsnummern (VINs), Fahrzeugseriennummern und Kennzeichennummern | CPRA, GDPR, HIPAA, APPI | #### PHI (geschützte Gesundheitsinformationen) | Label | Beschreibung | Einhaltung gesetzlicher Vorschriften | | ---------------------- | ---------------------------------------------------------------------------- | ----------------------------------------------------- | | `condition` | Namen medizinischer Zustände, Krankheiten, Syndrome, Defizite und Störungen | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI Sensitive | | `drug` | Medikamente, Vitamine und Nahrungsergänzungsmittel | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI Sensitive | | `injury` | Körperverletzungen, einschließlich Mutationen, Fehlgeburten und Verrenkungen | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI Sensitive | | `blood_type` | Blutgruppen | CPRA, GDPR, HIPAA, Quebec Privacy Act | | `medical_process` | Medizinische Prozesse, einschließlich Behandlungen, Verfahren und Tests | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI Sensitive | | `clinical_measurement` | Klinische Messwerte, Vitalwerte und Laborergebnisse | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI Sensitive | | `statistics` | Veralteter Alias für `clinical_measurement` | HIPAA, Quebec Privacy Act | #### PCI (Zahlungskartenbranche) | Label | Beschreibung | Einhaltung gesetzlicher Vorschriften | | ------------------------ | ---------------------------------------------------------- | ------------------------------------------- | | `credit_card` | Kreditkartennummern | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `credit_card_expiration` | Ablaufdatum einer Kreditkarte | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `cvv` | Drei- oder vierstellige Kartenprüfcodes und Entsprechungen | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | #### Andere Entitäten | Label | Beschreibung | Einhaltung gesetzlicher Vorschriften | | ----------------------- | ---------------------------------------------------------------------- | -------------------------------------------------------------- | | `language` | Namen natürlicher Sprachen | GDPR, GDPR Sensitive, APPI Sensitive | | `marital_status` | Begriffe für den Familienstand | APPI Sensitive | | `organization` | Namen von Organisationen oder Abteilungen innerhalb einer Organisation | Quebec Privacy Act, APPI | | `political_affiliation` | Begriffe für eine politische Partei, Bewegung oder Ideologie | CPRA, GDPR, GDPR Sensitive, Quebec Privacy Act, APPI Sensitive | | `religion` | Begriffe für die Religionszugehörigkeit | CPRA, GDPR, GDPR Sensitive, Quebec Privacy Act, APPI Sensitive | | `routing_number` | Bankleitzahl einer Bank oder eines Finanzinstituts | | | `zodiac_sign` | Namen von Sternzeichen | | | `product_or_service` | Namen kommerzieller Produkte oder Dienstleistungen | | | `food_or_beverage` | Namen von Lebensmitteln, Getränken und Gerichten | | | `document_reference` | Verweise auf Dokumente, Fallnummern oder Dateikennungen | | | `generic_id` | Allgemeine Kennungen, die nicht unter andere ID-Kategorien fallen | | | `measurement` | Physische Messwerte und Mengen mit Einheiten | | | `time_duration` | Ausdrücke für eine Dauer oder Zeitspanne | | #### Anstößige Sprache | Label | Beschreibung | Einhaltung gesetzlicher Vorschriften | | ------------------------- | ------------------------------------------------------ | ------------------------------------ | | `very_offensive_language` | Stark anstößige Sprache, einschließlich Schimpfwörtern | | | `less_offensive_language` | Leicht anstößige oder unangemessene Sprache | | ## Entitäten schwärzen Neben der Erkennung von Entitäten können Sie diese mit dem Parameter `entity_redaction` aus dem Transkripttext schwärzen. Er akzeptiert dasselbe Format wie `entity_detection`: `all`, ein Kategorie-Schlüsselwort oder eine Liste spezifischer Entitätstypen. Die geschwärzten Typen müssen eine Teilmenge der erkannten Typen sein. Wenn die Schwärzung aktiviert ist, wird übereinstimmender Entitätstext sowohl im Transkripttext als auch in der Ausgabe auf Wortebene durch eine Markierung ersetzt. Das Feld `entities` wird nicht in der Antwort zurückgegeben. ```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." ``` Der Parameter `entity_redaction_mode` steuert das Markierungsformat: | Modus | Markierung | Beispiel | | ------------------------ | ---------------------------------------- | ------------------------ | | `redacted` | `{REDACTED}` für jede Entität | `Hi {REDACTED}` | | `entity_type` | Der Entitätstyp in geschweiften Klammern | `Hi {NAME}` | | `enumerated_entity_type` | Der Entitätstyp plus Vorkommenszähler | `Hi {NAME_0}` (Standard) | > **Warning** > > Entitätserkennung und -schwärzung werden mit dem mehrkanaligen Ausgabestil `combined` nicht unterstützt. ## Nächste Schritte #### [API-Referenz](/docs/de/api-reference/speech-to-text) Vollständige Speech-to-Text-API-Referenz und Parameter. #### [Mehrkanalige Transkription](/docs/de/eleven-api/guides/how-to/speech-to-text/batch/multichannel-transcription) Transkribieren Sie mehrkanaliges Audio mit Sprecherzuordnung pro Kanal.