> ## 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.

# KI-Metadatenextraktion

> Wie Truthlocks KI nutzt, um Ihre geschützten Inhalte automatisch zu kategorisieren und zu beschreiben.

Wenn Sie Inhalte auf Truthlocks schützen, analysiert die KI Ihre Datei automatisch, um Metadaten zu generieren – einschließlich eines vorgeschlagenen Titels, einer Beschreibung, einer Kategorie und Tags. Dies bereichert Ihre Schutzdatensätze und erleichtert das Suchen, Teilen und Verifizieren.

## Funktionsweise

Wenn Sie eine Datei auf der Seite „Schützen“ hochladen, sendet Truthlocks den Dateinamen, den Typ, die Größe und eine Vorschau (für textbasierte Dateien) oder EXIF-Daten (für Bilder) an ein KI-Modell. Die Datei selbst bleibt in Ihrem Browser – nur Metadaten werden zur Analyse gesendet.

**1. Datei ausgewählt**

Sie wählen eine Datei aus oder ziehen sie auf die Seite „Schützen“.

**2. Metadaten extrahiert**

Truthlocks liest grundlegende Dateieigenschaften (Name, MIME-Typ, Größe) und, wo
extrahiert, falls zutreffend, EXIF-Daten aus Bildern oder eine Textvorschau aus Code und
Dokumentdateien.

**3. KI-Analyse**

Die extrahierten Metadaten werden an das KI-Modell gesendet, das eine strukturierte
Antwort mit Kategorie, Inhaltstyp, Beschreibung, vorgeschlagenem Titel, Tags,
und mehr.

**4. Überprüfen und bearbeiten**

KI-generierte Felder erscheinen als Vorschläge. Sie können jedes Feld bearbeiten, bevor
Bestätigung Ihres Schutzes.

> [!NOTE]
>
> Die KI-Metadatenextraktion erfolgt automatisch und läuft im Hintergrund, sobald Sie
> eine Datei auswählen. Sie haben immer das letzte Wort – bearbeiten oder überschreiben Sie jede
> Vorschlag vor dem Schutz.

## Unterstützte Kategorien

Die KI klassifiziert Ihre Inhalte basierend auf Dateityp und Inhaltsanalyse in eine der folgenden Kategorien:

| Kategorie | Dateitypen |
| - | - |
| **Fotografie** | JPEG, PNG, WebP, TIFF, RAW-Formate |
| **Digitale Kunst** | PSD, AI, SVG, Procreate, HEIC |
| **Quellcode** | JS, TS, Python, Go, Rust, Java, C/C++ und über 30 weitere Sprachen |
| **Dokument** | PDF, DOCX, TXT, Markdown, LaTeX |
| **Musik** | MP3, WAV, FLAC, AAC, MIDI |
| **Video** | MP4, MOV, AVI, WebM, MKV |
| **Design** | Figma, Sketch, XD-Dateien |
| **Daten** | CSV, JSON, XML, SQL, Parquet |

## Generierte Metadatenfelder

Die KI erzeugt die folgenden Felder für jede Datei:

| Feld | Beschreibung |
| - | - |
| `category` | Inhaltskategorie (siehe Tabelle oben) |
| `content_type` | Spezifischer Inhaltstyp innerhalb der Kategorie (z. B. „Landschaftsfotografie“) |
| `suggested_title` | Ein für Menschen lesbarer Titel basierend auf Dateiname und Inhalt |
| `description` | Eine kurze Beschreibung des Dateiinhaltes |
| `tags` | Relevante Schlüsselwörter für Suche und Entdeckung |
| `language` | Programmiersprache (für Quellcodedateien) |
| `framework` | Erkanntes Framework oder Bibliothek (für Quellcodedateien) |
| `license_hint` | Erkannte oder vorgeschlagene Lizenz (falls identifizierbar) |
| `subject_matter` | Das primäre Thema oder der Inhalt des Inhalts |

## Proof-Zusammenfassungen

Jedes Schutz-Zertifikat enthält eine KI-generierte Zusammenfassung, die beschreibt, was wann geschützt wurde. Die Zusammenfassung erscheint auf der öffentlichen Nachweisseite unter den Zertifikatsdetails und ist für die Freigabe und Link-Vorschauen konzipiert.

Proof-Zusammenfassungen werden automatisch generiert, wenn jemand eine Proof-Seite ansieht. Sie müssen sie nicht konfigurieren oder auslösen.

| Detail | Beschreibung |
| - | - |
| **Inhalt** | Eine 2-3 Sätze umfassende Erklärung des Schutzes – was geschützt wurde, seine Kategorie und das Schutzdatum |
| **Fallback** | Wenn KI nicht verfügbar ist, wird stattdessen eine vorlagenbasierte Zusammenfassung generiert, sodass die Proof-Seite immer eine lesbare Beschreibung anzeigt |
| **Indikator** | KI-generierte Zusammenfassungen zeigen ein kleines Glitzersymbol und die Bezeichnung „KI-generierte Zusammenfassung“ |
| **Caching** | Zusammenfassungen werden pro Proof-Seite zwischengespeichert und alle fünf Minuten neu validiert. Nachfolgende Besucher sehen die zwischengespeicherte Version, was die Latenz und die KI-Nutzung reduziert |

### Wie Caching funktioniert

Wenn der erste Besucher eine Proof-Seite lädt, generiert die Plattform eine KI-Zusammenfassung und speichert sie im Cache. Für die nächsten fünf Minuten sehen alle Besucher das zwischengespeicherte Ergebnis. Nach fünf Minuten löst die nächste Anfrage eine neue KI-Generierung aus und aktualisiert den Cache.

Wenn das KI-Modell zum Zeitpunkt der Generierung nicht verfügbar ist, ist das zwischengespeicherte Ergebnis stattdessen ein vorlagenbasierter Fallback. Der Cache gilt weiterhin – der Fallback wird bis zu fünf Minuten lang bereitgestellt, bevor die Plattform die KI-Generierung erneut versucht.

> [!NOTE]
>
> Proof-Zusammenfassungen werden zwischengespeichert und alle fünf Minuten neu validiert. Der erste Besucher einer Proof-Seite löst die Generierung der Zusammenfassung aus, und nachfolgende Besucher sehen die zwischengespeicherte Version, bis sie aktualisiert wird. Sie müssen das Caching nicht selbst verwalten.

### Fallback-Zusammenfassungen

Wenn das KI-Modell nicht verfügbar ist, zeigt die Proof-Seite stattdessen eine deterministische Vorlagenzusammenfassung an. Vorlagenzusammenfassungen umfassen:

* Die Inhaltskategorie und das Schutzdatum.
* Ein Hinweis, dass der kryptografische Beweis im Truthlocks-Transparenzprotokoll verankert ist.
* Ein Herkunftsindikator – wenn der Inhalt von einer Person (und nicht über API) hochgeladen wurde, enthält die Zusammenfassung einen Hinweis, der die menschliche Einreichung bestätigt.

Vorlagenzusammenfassungen zeigen kein Glitzersymbol, sodass Sie immer erkennen können, ob eine Zusammenfassung KI-generiert wurde.

> [!TIP]
>
> Proof-Zusammenfassungen verwenden nur die Metadaten, die Sie beim Schutz Ihrer Inhalte angegeben haben – Titel, Beschreibung, Kategorie und Datum. Ihre Originaldatei wird niemals abgerufen.

## Ähnlichkeitserkennung

Bevor eine Schutzmaßnahme geprägt wird, prüft Truthlocks, ob ein ähnlicher Dateihash bereits existiert. Dies verhindert doppelte Schutzmaßnahmen und warnt Sie, wenn der Inhalt zuvor registriert wurde – entweder von Ihnen oder von einem anderen Benutzer.

Wenn eine Übereinstimmung gefunden wird, sehen Sie eine Warnung mit Details zum bestehenden Schutz, bevor Sie fortfahren. Jede Übereinstimmung beinhaltet:

* **Ähnlichkeitswert** – wie genau der Inhalt mit einem bestehenden Schutz übereinstimmt.
* **Eigentümer** – der Benutzername der Person, die das Original geschützt hat.
* **Datum** – wann der ursprüngliche Schutz erstellt wurde.
* **Exakte Übereinstimmungskennzeichnung** – ob der Inhaltshash mit einem bestehenden Datensatz identisch ist.

## Verwendung von KI-Metadaten mit der API

Beim Aufruf des Mint-Endpunkts können Sie KI-extrahierte Felder einschließen, um Ihren Schutzdatensatz anzureichern:

```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]
>
> Bei Verwendung der API können Sie die KI-Extraktion überspringen und Ihre eigenen Metadaten bereitstellen
> direkt. Die KI-Extraktionsfunktion ist in der Weboberfläche und
> läuft automatisch.

## Datenschutz

Die KI-Metadatenextraktion folgt demselben Datenschutzmodell wie der Rest von Truthlocks:

* **Ihre Datei verlässt niemals Ihren Browser.** Nur der Dateiname, der MIME-Typ, die Größe und eine kleine Vorschau oder EXIF-Daten werden zur Analyse gesendet.
* **Es werden keine Dateiinhalte gespeichert** vom KI-Dienst. Metadaten werden in Echtzeit generiert und an Ihren Browser zurückgegeben.
* **Sie kontrollieren, was versendet wird.** Überprüfen und bearbeiten Sie alle KI-generierten Felder, bevor Sie Ihren Schutz bestätigen.

## Nächste Schritte

> [card] [Inhaltsschutz](https://docs.truthlocks.com/guides/content-protection.md)
>
> Vollständige Anleitung zum Schutz Ihrer Inhalte mit kryptografischen Bestätigungen.

> [card] [Verbraucherportal](https://docs.truthlocks.com/guides/consumer-portal.md)
>
> Verwalten Sie Schutzmaßnahmen, Anmeldeinformationen und Einstellungen über Ihr Dashboard.

> [card] [Einbettbare Badges](https://docs.truthlocks.com/guides/badges.md)
>
> Fügen Sie Verifizierungsabzeichen zu Ihrer Website oder README hinzu.

> [card] [Öffentliches Portfolio](https://docs.truthlocks.com/guides/portfolio.md)
>
> Präsentieren Sie verifizierte Arbeiten auf einer öffentlichen Profilseite.


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