> 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. # Entitetsidentifiering > **Note** > > **Guide** · Förutsätter att du har slutfört [snabbstartsguiden för Speech to Text ](/docs/sv/eleven-api/guides/cookbooks/speech-to-text). ## Översikt Entitetsidentifiering är en funktion som låter dig identifiera specifika ord och fraser i transkriptionen och ange deras exakta tidsstämplar. Den är användbar för att identifiera kreditkortsnummer, namn, medicinska tillstånd eller personnummer som sedan kan maskeras. När funktionen är aktiverad identifierar modellen specifika entitetstyper i transkriptionen och anger deras exakta tidsstämplar. Till exempel ger följande ljud: Följande transkription när vi anger `"pii"` (personligt identifierbar information) som entitetstyp: ```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 } ] } ``` Resultatet visar de PII-entiteter som identifierats i transkriptionen, med deras exakta tidsstämplar. ## Integrera entitetsidentifiering Entitetsidentifiering integreras i Speech to Text API genom att skicka parametern `entity_detection` till metoden `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); ``` ## Entitetstyper Följande entitetstyper stöds för identifiering. Du kan identifiera hela grupper med kategorinyckelorden `pii`, `phi`, `pci`, `other` eller `offensive_language`, eller ange enskilda entitetstyper med deras etikett. Använd kategorin `all` för att identifiera alla entitetstyper. #### PII (personligt identifierbar information) | Etikett | Beskrivning | Regelefterlevnad | | --------------------------- | -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- | | `account_number` | Kundkontonummer eller medlemsidentifieringsnummer | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `age` | Siffror kopplade till en persons ålder | GDPR, HIPAA, Quebec Privacy Act, APPI | | `bank_account` | Bankkontonummer och internationella motsvarigheter, till exempel IBAN | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `cardinal` | Numeriska uttryck i grundtal | | | `credit_card` | Kreditkortsnummer | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `credit_card_expiration` | Utgångsdatum för ett kreditkort | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `cvv` | Tresiffriga eller fyrsiffriga kortverifieringskoder och motsvarigheter | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `date` | Specifika kalenderdatum, som kan inkludera veckodagar, datum, månader eller år | HIPAA, Quebec Privacy Act | | `date_interval` | Bredare tidsperioder, inklusive datumintervall, månader, årstider, år och decennier | HIPAA | | `dob` | Födelsedatum | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `driver_license` | Körkortsnummer | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `email_address` | E-postadresser | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `event` | Namn på evenemang eller högtider | | | `filename` | Namn på datorfiler, inklusive filändelse eller filsökväg | | | `gender` | Termer som anger könsidentitet, inklusive slanguttryck | CPRA, GDPR, GDPR Sensitive, APPI Sensitive | | `gender_sexuality` | Äldre alias som omfattar både `gender` och `sexual_orientation` | CPRA, GDPR, GDPR Sensitive, APPI Sensitive | | `sexual_orientation` | Termer som anger sexuell läggning, inklusive slanguttryck | CPRA, GDPR, GDPR Sensitive, APPI Sensitive | | `healthcare_number` | Sjukvårdsnummer och nummer för mottagare av sjukförsäkring | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `ip_address` | IP-adresser på internet, inklusive IPv4- och IPv6-format | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `location` | Metaklass för alla namngivna platsreferenser | GDPR, HIPAA, APPI | | `location_address` | Fullständiga eller partiella fysiska postadresser | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `location_city` | Namn på kommuner, inklusive byar, orter och städer | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `location_coordinate` | Geografiska positioner angivna med latitud-, longitud- och/eller höjdkoordinater | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `location_country` | Landsnamn | GDPR, APPI | | `location_state` | Namn på delstater, provinser, territorier eller prefekturer | GDPR, APPI | | `location_zip` | Postnummer, inklusive ZIP+4 | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `money` | Namn på och/eller belopp i valutor | | | `name` | Namn på personer, utan personliga titlar som ”fru” eller ”herr” | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `name_given` | Namn som ges till en person, vanligtvis vid födseln; ofta för- eller mellannamn i västerländska kulturer | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `name_family` | Namn som anger en persons familj eller gemenskap; ofta efternamn i västerländska kulturer | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `name_medical_professional` | Namn inklusive titeln på en medicinsk yrkesperson, till exempel "läkare" | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `numerical_pii` | Numerisk PII som inte hör till andra kategorier | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `occupation` | Jobbtitlar eller yrken | Quebec Privacy Act, APPI | | `ordinal` | Numeriska uttryck i ordningstal | | | `origin` | Termer som anger nationalitet, etnicitet eller ursprung | CPRA, GDPR, GDPR Sensitive, Quebec Privacy Act, APPI Sensitive | | `passport_number` | Passnummer utfärdade av valfritt land | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `password` | Kontolösenord, PIN-koder, åtkomstnycklar eller verifieringssvar | CPRA, APPI | | `percent` | Numeriska uttryck som procenttal | | | `phone_number` | Telefon- eller faxnummer | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `physical_attribute` | Utmärkande kroppsliga egenskaper, inklusive termer som anger ras | CPRA, GDPR, GDPR Sensitive, APPI Sensitive | | `ssn` | Personnummer eller internationella motsvarande myndighetsutfärdade identifieringsnummer | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `time` | Uttryck som anger klockslag | | | `url` | Internetadresser | CPRA, GDPR, HIPAA, Quebec Privacy Act | | `username` | Användarnamn, inloggningsnamn eller kontonamn | CPRA, GDPR, APPI | | `vehicle_id` | Fordonsidentifieringsnummer (VIN), fordonsserienummer och registreringsnummer | CPRA, GDPR, HIPAA, APPI | #### PHI (skyddad hälsoinformation) | Etikett | Beskrivning | Regelefterlevnad | | ---------------------- | --------------------------------------------------------------------------------------- | ----------------------------------------------------- | | `condition` | Namn på medicinska tillstånd, sjukdomar, syndrom, funktionsnedsättningar och störningar | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI Sensitive | | `drug` | Läkemedel, vitaminer och kosttillskott | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI Sensitive | | `injury` | Kroppsskador, inklusive mutationer, missfall och urledvridningar | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI Sensitive | | `blood_type` | Blodgrupper | CPRA, GDPR, HIPAA, Quebec Privacy Act | | `medical_process` | Medicinska processer, inklusive behandlingar, procedurer och tester | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI Sensitive | | `clinical_measurement` | Kliniska mätvärden, vitalparametrar och laboratoriesvar | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI Sensitive | | `statistics` | Äldre alias för `clinical_measurement` | HIPAA, Quebec Privacy Act | #### PCI (betalningskortsbranschen) | Etikett | Beskrivning | Regelefterlevnad | | ------------------------ | ---------------------------------------------------------------------- | ------------------------------------------- | | `credit_card` | Kreditkortsnummer | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `credit_card_expiration` | Utgångsdatum för ett kreditkort | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `cvv` | Tresiffriga eller fyrsiffriga kortverifieringskoder och motsvarigheter | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | #### Andra entiteter | Etikett | Beskrivning | Regelefterlevnad | | ----------------------- | ------------------------------------------------------------------- | -------------------------------------------------------------- | | `language` | Namn på naturliga språk | GDPR, GDPR Sensitive, APPI Sensitive | | `marital_status` | Termer som anger civilstånd | APPI Sensitive | | `organization` | Namn på organisationer eller avdelningar inom en organisation | Quebec Privacy Act, APPI | | `political_affiliation` | Termer som syftar på ett politiskt parti, en rörelse eller ideologi | CPRA, GDPR, GDPR Sensitive, Quebec Privacy Act, APPI Sensitive | | `religion` | Termer som anger religiös tillhörighet | CPRA, GDPR, GDPR Sensitive, Quebec Privacy Act, APPI Sensitive | | `routing_number` | Clearingnummer kopplat till en bank eller finansinstitution | | | `zodiac_sign` | Namn på stjärntecken | | | `product_or_service` | Namn på kommersiella produkter eller tjänster | | | `food_or_beverage` | Namn på mat, drycker och rätter | | | `document_reference` | Referenser till dokument, ärendenummer eller filidentifierare | | | `generic_id` | Generiska identifierare som inte hör till andra ID-kategorier | | | `measurement` | Fysiska mått och kvantiteter med enheter | | | `time_duration` | Uttryck som anger en tidslängd eller tidsperiod | | #### Stötande språk | Etikett | Beskrivning | Regelefterlevnad | | ------------------------- | ---------------------------------------------------- | ---------------- | | `very_offensive_language` | Mycket stötande språk, inklusive nedsättande uttryck | | | `less_offensive_language` | Lätt stötande eller olämpligt språk | | ## Maskering av entiteter Utöver att identifiera entiteter kan du maskera dem i transkriptionstexten med parametern `entity_redaction`. Den använder samma format som `entity_detection`: `all`, ett kategorinyckelord eller en lista med specifika entitetstyper. De maskerade typerna måste vara en delmängd av de identifierade typerna. När maskering är aktiverad ersätts matchande entitetstext med en markör både i transkriptionstexten och i utdata på ordnivå, och fältet `entities` returneras inte i svaret. ```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." ``` Parametern `entity_redaction_mode` styr markörformatet: | Läge | Markör | Exempel | | ------------------------ | -------------------------------------- | ------------------------ | | `redacted` | `{REDACTED}` för varje entitet | `Hi {REDACTED}` | | `entity_type` | Entitetstypen inom klammerparenteser | `Hi {NAME}` | | `enumerated_entity_type` | Entitetstypen plus en förekomsträknare | `Hi {NAME_0}` (standard) | > **Warning** > > Identifiering och maskering av entiteter stöds inte med utdatastilen `combined` för flera kanaler. ## Nästa steg #### [API-referens](/docs/sv/api-reference/speech-to-text) Fullständig API-referens och parametrar för Speech to Text. #### [Transkribering av flera kanaler](/docs/sv/eleven-api/guides/how-to/speech-to-text/batch/multichannel-transcription) Transkribera ljud med flera kanaler med talarattribuering per kanal.