> 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. # Wykrywanie encji > **Note** > > **Przewodnik krok po kroku** · Zakłada, że masz za sobą [krótki przewodnik po Speech to Text ](/docs/pl/eleven-api/guides/cookbooks/speech-to-text). ## Omówienie Wykrywanie encji to funkcja, która pozwala wykrywać w transkrypcji konkretne słowa i wyrażenia oraz podaje ich dokładne znaczniki czasu. Przydaje się do wykrywania numerów kart kredytowych, imion i nazwisk, schorzeń czy numerów ubezpieczenia społecznego, które można potem zredagować. Po włączeniu model wykrywa określone typy encji w transkrypcji i podaje ich dokładne znaczniki czasu. Na przykład poniższe audio: Zwraca poniższą transkrypcję, gdy określimy `"pii"` (dane umożliwiające identyfikację osoby) jako typ encji: ```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 } ] } ``` Wynik pokazuje encje PII wykryte w transkrypcji wraz z ich dokładnymi znacznikami czasu. ## Integracja wykrywania encji Wykrywanie encji jest zintegrowane z API Speech to Text przez przekazanie parametru `entity_detection` do metody `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); ``` ## Typy encji Obsługujemy wykrywanie poniższych typów encji. Możesz wykrywać całe grupy za pomocą słów kluczowych kategorii `pii`, `phi`, `pci`, `other` lub `offensive_language`, albo wskazać pojedyncze typy encji według etykiety. Aby wykryć wszystkie typy encji, użyj kategorii `all`. #### PII (dane umożliwiające identyfikację osoby) | Etykieta | Opis | Zgodność z przepisami | | --------------------------- | ---------------------------------------------------------------------------------------------- | -------------------------------------------------------------- | | `account_number` | Numer identyfikacyjny konta klienta lub członkostwa | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `age` | Liczby związane z wiekiem osoby | GDPR, HIPAA, Quebec Privacy Act, APPI | | `bank_account` | Numery rachunków bankowych i ich międzynarodowe odpowiedniki, np. IBAN | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `cardinal` | Wyrażenia liczbowe w formie liczebników głównych | | | `credit_card` | Numery kart kredytowych | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `credit_card_expiration` | Data ważności karty kredytowej | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `cvv` | 3- lub 4-cyfrowe kody weryfikacyjne karty i ich odpowiedniki | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `date` | Konkretne daty kalendarzowe, w tym dni tygodnia, daty, miesiące i lata | HIPAA, Quebec Privacy Act | | `date_interval` | Szersze okresy, w tym zakresy dat, miesiące, pory roku, lata i dekady | HIPAA | | `dob` | Daty urodzenia | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `driver_license` | Numery prawa jazdy | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `email_address` | Adresy e-mail | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `event` | Nazwy wydarzeń lub świąt | | | `filename` | Nazwy plików komputerowych, w tym rozszerzenie lub ścieżka pliku | | | `gender` | Określenia tożsamości płciowej, także slangowe | CPRA, GDPR, GDPR Sensitive, APPI Sensitive | | `gender_sexuality` | Starszy alias obejmujący `gender` i `sexual_orientation` | CPRA, GDPR, GDPR Sensitive, APPI Sensitive | | `sexual_orientation` | Określenia orientacji seksualnej, także slangowe | CPRA, GDPR, GDPR Sensitive, APPI Sensitive | | `healthcare_number` | Numery ubezpieczenia zdrowotnego i numery beneficjentów planów zdrowotnych | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `ip_address` | Adres IP w internecie, w tym formaty IPv4 i IPv6 | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `location` | Metaklasa dla dowolnego nazwanego odniesienia do lokalizacji | GDPR, HIPAA, APPI | | `location_address` | Pełne lub częściowe fizyczne adresy korespondencyjne | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `location_city` | Nazwy gmin, w tym wsi, miasteczek i miast | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `location_coordinate` | Pozycje geograficzne określone współrzędnymi szerokości, długości geograficznej lub wysokości | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `location_country` | Nazwy państw | GDPR, APPI | | `location_state` | Nazwy stanów, prowincji, terytoriów lub prefektur | GDPR, APPI | | `location_zip` | Kody ZIP (w tym ZIP+4), kody pocztowe lub postal codes | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `money` | Nazwy lub kwoty walut | | | `name` | Imiona i nazwiska osób, bez tytułów osobistych, takich jak „pani” czy „pan” | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `name_given` | Imiona nadane osobie, zwykle przy urodzeniu; często imiona pierwsze/drugie w kulturach Zachodu | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `name_family` | Nazwy wskazujące rodzinę lub społeczność osoby; często nazwisko w kulturach Zachodu | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `name_medical_professional` | Nazwy wraz z tytułem pracownika medycznego, np. „doktor” | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `numerical_pii` | Numeryczne dane PII, które nie należą do innych kategorii | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `occupation` | Stanowiska lub zawody | Quebec Privacy Act, APPI | | `ordinal` | Wyrażenia liczbowe w formie liczebników porządkowych | | | `origin` | Określenia narodowości, pochodzenia etnicznego lub proweniencji | CPRA, GDPR, GDPR Sensitive, Quebec Privacy Act, APPI Sensitive | | `passport_number` | Numery paszportów wydanych przez dowolne państwo | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `password` | Hasła do kont, PIN-y, klucze dostępu lub odpowiedzi weryfikacyjne | CPRA, APPI | | `percent` | Wyrażenia liczbowe jako wartości procentowe | | | `phone_number` | Numery telefonu lub faksu | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `physical_attribute` | Charakterystyczne cechy fizyczne, w tym określenia rasy | CPRA, GDPR, GDPR Sensitive, APPI Sensitive | | `ssn` | Numery Social Security lub równoważne numery identyfikacyjne wydawane przez państwo | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `time` | Wyrażenia wskazujące godziny | | | `url` | Adresy internetowe | CPRA, GDPR, HIPAA, Quebec Privacy Act | | `username` | Nazwy użytkownika, loginy lub pseudonimy | CPRA, GDPR, APPI | | `vehicle_id` | Numery identyfikacyjne pojazdów (VIN), numery seryjne pojazdów i numery rejestracyjne | CPRA, GDPR, HIPAA, APPI | #### PHI (chronione informacje o zdrowiu) | Etykieta | Opis | Zgodność z przepisami | | ---------------------- | ------------------------------------------------------------------- | ----------------------------------------------------- | | `condition` | Nazwy schorzeń, chorób, zespołów, deficytów i zaburzeń | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI Sensitive | | `drug` | Leki, witaminy i suplementy | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI Sensitive | | `injury` | Urazy ciała, w tym mutacje, poronienia i zwichnięcia | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI Sensitive | | `blood_type` | Grupy krwi | CPRA, GDPR, HIPAA, Quebec Privacy Act | | `medical_process` | Procesy medyczne, w tym leczenie, procedury i badania | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI Sensitive | | `clinical_measurement` | Pomiary kliniczne, parametry życiowe i wyniki badań laboratoryjnych | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI Sensitive | | `statistics` | Starszy alias dla `clinical_measurement` | HIPAA, Quebec Privacy Act | #### PCI (branża kart płatniczych) | Etykieta | Opis | Zgodność z przepisami | | ------------------------ | ------------------------------------------------------------ | ------------------------------------------- | | `credit_card` | Numery kart kredytowych | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `credit_card_expiration` | Data ważności karty kredytowej | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | | `cvv` | 3- lub 4-cyfrowe kody weryfikacyjne karty i ich odpowiedniki | CPRA, GDPR, HIPAA, Quebec Privacy Act, APPI | #### Inne encje | Etykieta | Opis | Zgodność z przepisami | | ----------------------- | ----------------------------------------------------------------- | -------------------------------------------------------------- | | `language` | Nazwy języków naturalnych | GDPR, GDPR Sensitive, APPI Sensitive | | `marital_status` | Określenia stanu cywilnego | APPI Sensitive | | `organization` | Nazwy organizacji lub działów w organizacji | Quebec Privacy Act, APPI | | `political_affiliation` | Określenia partii politycznej, ruchu lub ideologii | CPRA, GDPR, GDPR Sensitive, Quebec Privacy Act, APPI Sensitive | | `religion` | Określenia przynależności religijnej | CPRA, GDPR, GDPR Sensitive, Quebec Privacy Act, APPI Sensitive | | `routing_number` | Numer rozliczeniowy powiązany z bankiem lub instytucją finansową | | | `zodiac_sign` | Nazwy znaków zodiaku | | | `product_or_service` | Nazwy produktów lub usług komercyjnych | | | `food_or_beverage` | Nazwy żywności, napojów i dań | | | `document_reference` | Odniesienia do dokumentów, numery spraw lub identyfikatory plików | | | `generic_id` | Ogólne identyfikatory, które nie należą do innych kategorii ID | | | `measurement` | Pomiary fizyczne i ilości z jednostkami | | | `time_duration` | Wyrażenia wskazujące długość lub okres czasu | | #### Obraźliwy język | Etykieta | Opis | Zgodność z przepisami | | ------------------------- | --------------------------------------- | --------------------- | | `very_offensive_language` | Bardzo obraźliwy język, w tym obelgi | | | `less_offensive_language` | Lekko obraźliwy lub nieodpowiedni język | | ## Redagowanie encji Oprócz wykrywania encji możesz usuwać je z tekstu transkrypcji za pomocą parametru `entity_redaction`. Przyjmuje on ten sam format co `entity_detection`: `all`, słowo kluczowe kategorii lub listę konkretnych typów encji. Typy do usunięcia muszą być podzbiorem wykrytych typów. Gdy redagowanie jest włączone, dopasowany tekst encji zostaje zastąpiony znacznikiem zarówno w tekście transkrypcji, jak i w danych na poziomie słów, a pole `entities` nie jest zwracane w odpowiedzi. ```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." ``` Parametr `entity_redaction_mode` określa format znacznika: | Tryb | Znacznik | Przykład | | ------------------------ | -------------------------------- | ------------------------- | | `redacted` | `{REDACTED}` dla każdej encji | `Hi {REDACTED}` | | `entity_type` | Typ encji w nawiasach klamrowych | `Hi {NAME}` | | `enumerated_entity_type` | Typ encji i licznik wystąpień | `Hi {NAME_0}` (domyślnie) | > **Warning** > > Wykrywanie i redagowanie encji nie jest obsługiwane przy stylu wyjścia wielokanałowego `combined`. ## Następne kroki #### [Dokumentacja API](/docs/pl/api-reference/speech-to-text) Pełna dokumentacja API Speech to Text i parametry. #### [Transkrypcja wielokanałowa](/docs/pl/eleven-api/guides/how-to/speech-to-text/batch/multichannel-transcription) Transkrybuj wielokanałowe audio z przypisaniem mówców do kanałów.