> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Extraction de métadonnées par IA

> Comment Truthlocks utilise l'IA pour catégoriser et décrire automatiquement votre contenu protégé.

Lorsque vous protégez du contenu sur Truthlocks, l'IA analyse automatiquement votre fichier pour générer des métadonnées — y compris un titre suggéré, une description, une catégorie et des balises. Cela enrichit vos enregistrements de protection et les rend plus faciles à rechercher, partager et vérifier.

## Comment ça marche

Lorsque vous téléchargez un fichier sur la page Protéger, Truthlocks envoie le nom du fichier, le type, la taille et un aperçu (pour les fichiers texte) ou les données EXIF (pour les images) à un modèle d'IA. Le fichier lui-même reste dans votre navigateur — seules les métadonnées sont envoyées pour analyse.

**1. Fichier sélectionné**

Vous sélectionnez ou faites glisser un fichier sur la page Protéger.

**2. Métadonnées extraites**

Truthlocks lit les propriétés de base du fichier (nom, type MIME, taille) et, le cas échéant,
le cas échéant, extrait les données EXIF des images ou un aperçu textuel du code et
fichiers de documents.

**3. Analyse IA**

Les métadonnées extraites sont envoyées au modèle d'IA, qui renvoie un résultat structuré
réponse avec catégorie, type de contenu, description, titre suggéré, balises,
et plus encore.

**4. Examiner et modifier**

Les champs générés par l'IA apparaissent comme des suggestions. Vous pouvez modifier n'importe quel champ avant
confirmant votre protection.

> [!NOTE]
>
> L'extraction de métadonnées par IA est automatique et s'exécute en arrière-plan dès que vous
> sélectionnez un fichier. Vous avez toujours le dernier mot — modifiez ou annulez tout
> suggestion avant de protéger.

## Catégories prises en charge

L'IA classe votre contenu dans l'une des catégories suivantes en fonction du type de fichier et de l'analyse du contenu :

| Catégorie | Types de fichiers |
| - | - |
| **Photographie** | Formats JPEG, PNG, WebP, TIFF, RAW |
| **Art numérique** | PSD, AI, SVG, Procreate, HEIC |
| **Code source** | JS, TS, Python, Go, Rust, Java, C/C++ et plus de 30 autres langages |
| **Document** | PDF, DOCX, TXT, Markdown, LaTeX |
| **Musique** | MP3, WAV, FLAC, AAC, MIDI |
| **Vidéo** | MP4, MOV, AVI, WebM, MKV |
| **Design** | Fichiers Figma, Sketch, XD |
| **Données** | CSV, JSON, XML, SQL, Parquet |

## Champs de métadonnées générés

L'IA produit les champs suivants pour chaque fichier :

| Champ | Description |
| - | - |
| `category` | Catégorie de contenu (voir tableau ci-dessus) |
| `content_type` | Type de contenu spécifique au sein de la catégorie (par exemple, "photographie de paysage") |
| `suggested_title` | Un titre lisible par l'homme basé sur le nom et le contenu du fichier |
| `description` | Une courte description du contenu du fichier |
| `tags` | Mots-clés pertinents pour la recherche et la découverte |
| `language` | Langage de programmation (pour les fichiers de code source) |
| `framework` | Cadre ou bibliothèque détecté (pour les fichiers de code source) |
| `license_hint` | Licence détectée ou suggérée (si identifiable) |
| `subject_matter` | Le sujet principal ou le thème du contenu |

## Résumés de preuves

Chaque certificat de protection comprend un résumé généré par l'IA qui décrit ce qui a été protégé et quand. Le résumé apparaît sur la page de preuve publique sous les détails du certificat et est conçu pour le partage et les aperçus de liens.

Les résumés de preuves sont générés automatiquement lorsque quelqu'un consulte une page de preuve. Vous n'avez pas besoin de les configurer ou de les déclencher.

| Détail | Description |
| - | - |
| **Contenu** | Une explication de 2 à 3 phrases de la protection — ce qui a été protégé, sa catégorie et la date de protection |
| **Repli** | Si l'IA n'est pas disponible, un résumé basé sur un modèle est généré à la place afin que la page de preuve affiche toujours une description lisible |
| **Indicateur** | Les résumés générés par l'IA affichent une petite icône étincelante et une étiquette "Résumé généré par l'IA" |
| **Mise en cache** | Les résumés sont mis en cache par page de preuve et revalidés toutes les cinq minutes. Les visiteurs suivants voient la version mise en cache, ce qui réduit la latence et l'utilisation de l'IA |

### Comment fonctionne la mise en cache

Lorsque le premier visiteur charge une page de preuve, la plateforme génère un résumé IA et le met en cache. Pendant les cinq minutes suivantes, tous les visiteurs voient le résultat mis en cache. Après cinq minutes, la requête suivante déclenche une nouvelle génération IA et rafraîchit le cache.

Si le modèle d'IA n'est pas disponible au moment de la génération, le résultat mis en cache est une solution de repli basée sur un modèle. Le cache s'applique toujours — la solution de repli est servie pendant cinq minutes maximum avant que la plateforme ne tente à nouveau la génération d'IA.

> [!NOTE]
>
> Les résumés de preuve sont mis en cache et revalidés toutes les cinq minutes. Le premier visiteur d'une page de preuve déclenche la génération du résumé, et les visiteurs suivants voient la version mise en cache jusqu'à son rafraîchissement. Vous n'avez pas besoin de gérer la mise en cache vous-même.

### Résumés de secours

Lorsque le modèle d'IA n'est pas disponible, la page de preuve affiche un résumé de modèle déterministe à la place. Les résumés de modèle incluent :

* La catégorie de contenu et la date de protection.
* Une note indiquant que la preuve cryptographique est ancrée au journal de transparence Truthlocks.
* Un indicateur de provenance — si le contenu a été téléchargé par une personne (plutôt que via une API), le résumé inclut une note confirmant la soumission humaine.

Les résumés de modèles n'affichent pas l'icône étincelante, vous pouvez donc toujours savoir si un résumé a été généré par l'IA.

> [!TIP]
>
> Les résumés de preuve utilisent uniquement les métadonnées que vous avez fournies lors de la protection de votre contenu — titre, description, catégorie et date. Votre fichier original n'est jamais accédé.

## Détection de similarité

Avant de créer une protection, Truthlocks vérifie si un hachage de fichier similaire existe déjà. Cela empêche les protections en double et vous alerte si le contenu a déjà été enregistré — soit par vous, soit par un autre utilisateur.

Si une correspondance est trouvée, un avertissement avec des détails sur la protection existante s'affiche avant de continuer. Chaque correspondance comprend :

* **Score de similarité** — à quel point le contenu correspond à une protection existante.
* **Propriétaire** — le nom d'utilisateur de la personne qui a protégé l'original.
* **Date** — date de création de la protection originale.
* **Drapeau de correspondance exacte** — indique si le hachage du contenu est identique à un enregistrement existant.

## Utilisation des métadonnées d'IA avec l'API

Lors de l'appel du point de terminaison de frappe, vous pouvez inclure des champs extraits par l'IA pour enrichir votre enregistrement de protection :

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/consumer/mint \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "content_hash": "e3b0c44298fc1c149afbf4c8...",
    "title": "Sunset at Big Sur",
    "description": "Landscape photograph taken at Pfeiffer Beach",
    "file_name": "sunset-big-sur.jpg",
    "file_size": 4521984,
    "content_type": "landscape photography",
    "category": "photography",
    "tags": ["landscape", "sunset", "california", "beach"],
    "visibility": "public"
  }'
```

> [!TIP]
>
> Lorsque vous utilisez l'API, vous pouvez ignorer l'extraction AI et fournir vos propres métadonnées
> directement. La fonction d'extraction IA est disponible sur l'interface web et
> s'exécute automatiquement.

## Confidentialité

L'extraction de métadonnées par IA suit le même modèle de confidentialité que le reste de Truthlocks :

* **Votre fichier ne quitte jamais votre navigateur.** Seuls le nom du fichier, le type MIME, la taille et un petit aperçu ou les données EXIF sont envoyés pour analyse.
* **Aucun contenu de fichier n'est stocké** par le service d'IA. Les métadonnées sont générées en temps réel et renvoyées à votre navigateur.
* **Vous contrôlez ce qui est expédié.** Révisez et modifiez tous les champs générés par l'IA avant de confirmer votre protection.

## Prochaines étapes

> [card] [Protection du contenu](https://docs.truthlocks.com/guides/content-protection.md)
>
> Guide complet pour protéger votre contenu avec des attestations cryptographiques.

> [card] [Portail consommateur](https://docs.truthlocks.com/guides/consumer-portal.md)
>
> Gérez les protections, les identifiants et les paramètres depuis votre tableau de bord.

> [card] [Badges intégrables](https://docs.truthlocks.com/guides/badges.md)
>
> Ajoutez des badges de vérification à votre site web ou à votre fichier README.

> [card] [Portefeuille public](https://docs.truthlocks.com/guides/portfolio.md)
>
> Présentez le travail vérifié sur une page de profil public.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.