> 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. # Détection d’entités > **Note** > > **Guide pratique** · Suppose que vous avez terminé le [guide de démarrage rapide Speech to Text](/docs/fr/eleven-api/guides/cookbooks/speech-to-text). ## Présentation La détection d’entités est une fonctionnalité qui vous permet de détecter des mots et expressions spécifiques dans la transcription, en fournissant leurs horodatages exacts. Elle est utile pour détecter des numéros de carte bancaire, des noms, des pathologies ou des numéros de sécurité sociale, qui peuvent ensuite être masqués. Lorsqu’elle est activée, le modèle détecte des types d’entités spécifiques dans la transcription et fournit leurs horodatages exacts. Par exemple, l’audio suivant : Produit la transcription suivante lorsque nous spécifions `"pii"` (informations personnelles identifiables) comme type d’entité : ```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 } ] } ``` Le résultat affiche les entités PII détectées dans la transcription, avec leurs horodatages exacts. ## Intégrer la détection d’entités La détection d’entités s’intègre à l’API Speech to Text en transmettant le paramètre `entity_detection` à la méthode `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); ``` ## Types d’entités Les types d’entités suivants sont pris en charge pour la détection. Vous pouvez détecter des groupes entiers à l’aide des mots-clés de catégorie `pii`, `phi`, `pci`, `other` ou `offensive_language`, ou spécifier des types d’entités individuels à l’aide de leur libellé. Pour détecter tous les types d’entités, utilisez la catégorie `all`. #### PII (informations personnelles identifiables) | Libellé | Description | Conformité réglementaire | | --------------------------- | --------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | | `account_number` | Numéro d’identification de compte client ou d’adhésion | CPRA, RGPD, HIPAA, loi québécoise sur la protection de la vie privée, APPI | | `age` | Nombres associés à l’âge d’une personne | RGPD, HIPAA, loi québécoise sur la protection de la vie privée, APPI | | `bank_account` | Numéros de compte bancaire et équivalents internationaux, tels que l’IBAN | CPRA, RGPD, HIPAA, loi québécoise sur la protection de la vie privée, APPI | | `cardinal` | Expressions numériques sous forme cardinale | | | `credit_card` | Numéros de carte bancaire | CPRA, RGPD, HIPAA, loi québécoise sur la protection de la vie privée, APPI | | `credit_card_expiration` | Date d’expiration d’une carte bancaire | CPRA, RGPD, HIPAA, loi québécoise sur la protection de la vie privée, APPI | | `cvv` | Codes de vérification de carte à 3 ou 4 chiffres et équivalents | CPRA, RGPD, HIPAA, loi québécoise sur la protection de la vie privée, APPI | | `date` | Dates calendaires précises, pouvant inclure des jours de la semaine, des dates, des mois ou des années | HIPAA, loi québécoise sur la protection de la vie privée | | `date_interval` | Périodes plus larges, y compris des plages de dates, mois, saisons, années et décennies | HIPAA | | `dob` | Dates de naissance | CPRA, RGPD, HIPAA, loi québécoise sur la protection de la vie privée, APPI | | `driver_license` | Numéros de permis de conduire | CPRA, RGPD, HIPAA, loi québécoise sur la protection de la vie privée, APPI | | `email_address` | Adresses email | CPRA, RGPD, HIPAA, loi québécoise sur la protection de la vie privée, APPI | | `event` | Noms d’événements ou de jours fériés | | | `filename` | Noms de fichiers informatiques, y compris l’extension ou le chemin de fichier | | | `gender` | Termes indiquant l’identité de genre, y compris des termes d’argot | CPRA, RGPD, RGPD sensible, APPI sensible | | `gender_sexuality` | Alias historique couvrant à la fois `gender` et `sexual_orientation` | CPRA, RGPD, RGPD sensible, APPI sensible | | `sexual_orientation` | Termes indiquant l’orientation sexuelle, y compris des termes d’argot | CPRA, RGPD, RGPD sensible, APPI sensible | | `healthcare_number` | Numéros de santé et numéros de bénéficiaire de régime de santé | CPRA, RGPD, HIPAA, loi québécoise sur la protection de la vie privée, APPI | | `ip_address` | Adresse IP Internet, y compris les formats IPv4 et IPv6 | CPRA, RGPD, HIPAA, loi québécoise sur la protection de la vie privée, APPI | | `location` | Métaclasse pour toute référence à un lieu nommé | RGPD, HIPAA, APPI | | `location_address` | Adresses postales physiques complètes ou partielles | CPRA, RGPD, HIPAA, loi québécoise sur la protection de la vie privée, APPI | | `location_city` | Noms de municipalités, y compris villages, bourgs et villes | CPRA, RGPD, HIPAA, loi québécoise sur la protection de la vie privée, APPI | | `location_coordinate` | Positions géographiques référencées par des coordonnées de latitude, longitude et/ou altitude | CPRA, RGPD, HIPAA, loi québécoise sur la protection de la vie privée, APPI | | `location_country` | Noms de pays | RGPD, APPI | | `location_state` | Noms d’États, provinces, territoires ou préfectures | RGPD, APPI | | `location_zip` | Codes ZIP, y compris ZIP+4, codes postaux ou codes de distribution | CPRA, RGPD, HIPAA, loi québécoise sur la protection de la vie privée, APPI | | `money` | Noms et/ou montants de devises | | | `name` | Noms de personnes, à l’exclusion des titres personnels tels que « Mme » ou « M. » | CPRA, RGPD, HIPAA, loi québécoise sur la protection de la vie privée, APPI | | `name_given` | Prénoms attribués à une personne, généralement à la naissance, souvent prénom(s) en Occident | CPRA, RGPD, HIPAA, loi québécoise sur la protection de la vie privée, APPI | | `name_family` | Noms indiquant la famille ou la communauté d’une personne, souvent le nom de famille en Occident | CPRA, RGPD, HIPAA, loi québécoise sur la protection de la vie privée, APPI | | `name_medical_professional` | Noms incluant le titre d’un professionnel de santé, tel que « Docteur » | CPRA, RGPD, HIPAA, loi québécoise sur la protection de la vie privée, APPI | | `numerical_pii` | Informations personnelles identifiables numériques ne relevant pas d’autres catégories | CPRA, RGPD, HIPAA, loi québécoise sur la protection de la vie privée, APPI | | `occupation` | Intitulés de poste ou professions | loi québécoise sur la protection de la vie privée, APPI | | `ordinal` | Expressions numériques sous forme ordinale | | | `origin` | Termes indiquant la nationalité, l’origine ethnique ou la provenance | CPRA, RGPD, RGPD sensible, loi québécoise sur la protection de la vie privée, APPI sensible | | `passport_number` | Numéros de passeport, délivrés par tout pays | CPRA, RGPD, HIPAA, loi québécoise sur la protection de la vie privée, APPI | | `password` | Mots de passe de compte, codes PIN, clés d’accès ou réponses de vérification | CPRA, APPI | | `percent` | Expressions numériques sous forme de pourcentages | | | `phone_number` | Numéros de téléphone ou de fax | CPRA, RGPD, HIPAA, loi québécoise sur la protection de la vie privée, APPI | | `physical_attribute` | Caractéristiques physiques distinctives, y compris les termes indiquant la race | CPRA, RGPD, RGPD sensible, APPI sensible | | `ssn` | Numéros de sécurité sociale ou numéros d’identification gouvernementaux internationaux équivalents | CPRA, RGPD, HIPAA, loi québécoise sur la protection de la vie privée, APPI | | `time` | Expressions indiquant des heures | | | `url` | Adresses Internet | CPRA, RGPD, HIPAA, loi québécoise sur la protection de la vie privée | | `username` | Noms d’utilisateur, identifiants de connexion ou pseudonymes | CPRA, RGPD, APPI | | `vehicle_id` | Numéros d’identification de véhicule (VIN), numéros de série de véhicule et numéros de plaque d’immatriculation | CPRA, RGPD, HIPAA, APPI | #### PHI (informations de santé protégées) | Libellé | Description | Conformité réglementaire | | ---------------------- | -------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | | `condition` | Noms de pathologies, maladies, syndromes, déficiences et troubles médicaux | CPRA, RGPD, HIPAA, loi québécoise sur la protection de la vie privée, APPI sensible | | `drug` | Médicaments, vitamines et compléments alimentaires | CPRA, RGPD, HIPAA, loi québécoise sur la protection de la vie privée, APPI sensible | | `injury` | Blessures corporelles, y compris mutations, fausses couches et luxations | CPRA, RGPD, HIPAA, loi québécoise sur la protection de la vie privée, APPI sensible | | `blood_type` | Groupes sanguins | CPRA, RGPD, HIPAA, loi québécoise sur la protection de la vie privée | | `medical_process` | Processus médicaux, y compris traitements, procédures et examens | CPRA, RGPD, HIPAA, loi québécoise sur la protection de la vie privée, APPI sensible | | `clinical_measurement` | Mesures cliniques, constantes vitales et résultats de laboratoire | CPRA, RGPD, HIPAA, loi québécoise sur la protection de la vie privée, APPI sensible | | `statistics` | Alias historique de `clinical_measurement` | HIPAA, loi québécoise sur la protection de la vie privée | #### PCI (secteur des cartes de paiement) | Libellé | Description | Conformité réglementaire | | ------------------------ | --------------------------------------------------------------- | -------------------------------------------------------------------------- | | `credit_card` | Numéros de carte bancaire | CPRA, RGPD, HIPAA, loi québécoise sur la protection de la vie privée, APPI | | `credit_card_expiration` | Date d’expiration d’une carte bancaire | CPRA, RGPD, HIPAA, loi québécoise sur la protection de la vie privée, APPI | | `cvv` | Codes de vérification de carte à 3 ou 4 chiffres et équivalents | CPRA, RGPD, HIPAA, loi québécoise sur la protection de la vie privée, APPI | #### Autres entités | Libellé | Description | Conformité réglementaire | | ----------------------- | -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | | `language` | Noms de langues naturelles | RGPD, RGPD sensible, APPI sensible | | `marital_status` | Termes indiquant la situation matrimoniale | APPI sensible | | `organization` | Noms d’organisations ou de services au sein d’une organisation | loi québécoise sur la protection de la vie privée, APPI | | `political_affiliation` | Termes faisant référence à un parti, mouvement ou idéologie politique | CPRA, RGPD, RGPD sensible, loi québécoise sur la protection de la vie privée, APPI sensible | | `religion` | Termes indiquant une appartenance religieuse | CPRA, RGPD, RGPD sensible, loi québécoise sur la protection de la vie privée, APPI sensible | | `routing_number` | Numéro de routage associé à une banque ou institution financière | | | `zodiac_sign` | Noms de signes du zodiaque | | | `product_or_service` | Noms de produits ou services commerciaux | | | `food_or_beverage` | Noms d’aliments, de boissons et de plats | | | `document_reference` | Références à des documents, numéros de dossier ou identifiants de fichier | | | `generic_id` | Identifiants génériques ne relevant pas d’autres catégories d’identifiants | | | `measurement` | Mesures physiques et quantités avec unités | | | `time_duration` | Expressions indiquant une durée ou un laps de temps | | #### Langage offensant | Libellé | Description | Conformité réglementaire | | ------------------------- | ---------------------------------------------- | ------------------------ | | `very_offensive_language` | Langage très offensant, y compris les insultes | | | `less_offensive_language` | Langage légèrement offensant ou inapproprié | | ## Masquage des entités En plus de détecter les entités, vous pouvez les masquer dans le texte de la transcription avec le paramètre `entity_redaction`. Il accepte le même format que `entity_detection` : `all`, un mot-clé de catégorie ou une liste de types d’entités spécifiques. Les types masqués doivent constituer un sous-ensemble des types détectés. Lorsque le masquage est activé, le texte des entités correspondantes est remplacé par un marqueur dans le texte de la transcription comme dans la sortie au niveau des mots, et le champ `entities` n’est pas renvoyé dans la réponse. ```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." ``` Le paramètre `entity_redaction_mode` contrôle le format du marqueur : | Mode | Marqueur | Exemple | | ------------------------ | ----------------------------------------------- | -------------------------- | | `redacted` | `{REDACTED}` pour chaque entité | `Hi {REDACTED}` | | `entity_type` | Le type d’entité entre accolades | `Hi {NAME}` | | `enumerated_entity_type` | Le type d’entité avec un compteur d’occurrences | `Hi {NAME_0}` (par défaut) | > **Warning** > > La détection et le masquage des entités ne sont pas pris en charge avec le style de sortie multicanal `combined`. ## Étapes suivantes #### [Guide de l’API](/docs/fr/api-reference/speech-to-text) Guide complet de l’API Speech to Text et de ses paramètres. #### [Transcription multicanal](/docs/fr/eleven-api/guides/how-to/speech-to-text/batch/multichannel-transcription) Transcrivez de l’audio multicanal avec attribution des locuteurs par canal.