Dokumentation

Alles, was Sie brauchen, um Hinweise nach Artikel 50 auszuliefern. Ihre Schlüssel finden Sie bei einem Produkt in Ihrem Dashboard.

Widget einbinden

Kopieren Sie das vollständige Snippet von Ihrer Produktseite. Der öffentliche Schlüssel, der Artefakt-Hash und die Version binden die Einbindung an die von Ihnen veröffentlichte Konfiguration; eine veraltete oder veränderte Einbindung schlägt bewusst fehl. Der enthaltene noscript-Link erhält einen Weg zum Hinweis, wenn JavaScript nicht verfügbar ist. Das Widget rendert in einem isolierten Shadow DOM, ist unter 15 KB gzip groß, hat keine Abhängigkeiten und setzt keine Cookies.

Automatische Initialisierung

<script src="https://disclosekit.eu/widget/v1.js" data-key="pk_ihr_key" data-dk-artifact="ihr_veroeffentlichter_artefakt_hash" data-dk-version="1" defer></script> <noscript><a href="https://disclosekit.eu/t/ihr-transparenz-slug">KI-Hinweis und Transparenzinformationen</a></noscript>

Wenn Sie den Hinweis selbst platzieren möchten (zum Beispiel innerhalb eines Chat-Widgets), verwenden Sie stattdessen das eigene Element. Behalten Sie das Script-Tag bei und tragen Sie den aktuellen Artefakt-Hash in data-artifact ein:

Manuelle Platzierung

<disclosekit-notice data-key="pk_ihr_key" data-artifact="ihr_veroeffentlichter_artefakt_hash"></disclosekit-notice>
  • Varianten: schwebendes Badge, Banner oben/unten, Inline-Chip, Hinweis vor dem Chat — konfigurierbar im Dashboard.
  • Sprachen: Englisch, Deutsch und Französisch, automatisch anhand des Browsers gewählt, mit Englisch als Rückfall.
  • Barrierefreiheit: Der Hinweis nutzt eine Live-Status-Rolle, lässt sich per Tastatur schließen (Esc) und berücksichtigt prefers-reduced-motion.
  • Impressionen: Das Widget sendet ein cookiefreies Signal, das einen anonymen Tageszähler erhöht. Es wird keine IP-Adresse gespeichert.

Maschinenlesbare Kennzeichnung

Artikel 50 Absatz 2 verlangt, dass KI-generierte Inhalte in einem maschinenlesbaren Format gekennzeichnet werden. DiscloseKit erzeugt je Inhaltstyp drei interoperable Signale: HTML-meta-Tags, einen JSON-LD-Block und Beispiele für HTTP-Header. Sie erzeugen sie im Dashboard im Reiter „Kennzeichnung“ eines Produkts.

Das ist eine dokumentierte Konvention, kein kryptografischer Standard für Herkunftsnachweise. Für signierte Herkunftsnachweise siehe C2PA. DiscloseKit setzt C2PA in dieser Version nicht um. Der freiwillige EU Code of Practice on transparency of AI-generated content beschreibt, wie sich die Pflicht in der Praxis umsetzen lässt.

Kennzeichnungs-API

In den kostenpflichtigen Tarifen hat jedes Produkt einen geheimen API-Schlüssel (sk_…). Senden Sie einen Inhaltstyp per POST und Sie erhalten die Kennzeichnungs-Snippets als JSON zurück. Jeder Aufruf wird in Ihrem Nachweisprotokoll festgehalten.

POST /api/v1/mark

curl -X POST https://disclosekit.eu/api/v1/mark \ -H "Authorization: Bearer sk_ihr_geheimer_key" \ -H "Content-Type: application/json" \ -d '{"content_type":"image","url":"https://acme.com/asset.png"}'

content_type muss einer der Werte text, image, audio oder video sein. Übergeben Sie optional eine url, um sie in das JSON-LD aufzunehmen. Antworten enthalten metaTags, jsonLd und httpHeader.

Quellen

Dies ist ein Compliance-Werkzeug, keine Rechtsberatung. Lassen Sie Ihren konkreten Fall anwaltlich prüfen.