Zum Inhalt springen
Kennmarq.com, Startseite
Menü

Schnellstart

Fünf Minuten von der Registrierung bis zu Ihrem ersten markierten Bild: ein kostenloser Schlüssel und eine Anfrage. Sie erhalten dasselbe Bild zurück, mit einem unsichtbaren Wasserzeichen und signierten Content Credentials mit Zeitstempel – den Markierungen, die die KI-Verordnung der EU und Kalifornien verlangen.

Sie nutzen einen Coding-Agenten? Geben Sie Cursor oder Claude Code den Prompt auf unserer Startseite; er liest diese Dokumentation unter kennmarq.com/llms.txt (Englisch).

Basis-URL

Alle Endpunkte liegen unter https://api.kennmarq.com und sind nur über HTTPS erreichbar. Anfragen und Fehler beschreibt die API-Referenz.

1. Konto erstellen

Registrieren Sie sich mit Ihrer geschäftlichen E-Mail-Adresse und bestätigen Sie sie über den Link, den wir Ihnen senden. Ihre Organisation und ein Projekt namens Default werden für Sie angelegt. Schlüssel lassen sich erst erstellen, wenn Ihre E-Mail-Adresse bestätigt ist.

2. Testschlüssel erstellen

Öffnen Sie im Dashboard API-Schlüssel und erstellen Sie einen Schlüssel im Projekt Default in der Umgebung Test mit der Berechtigung mark. Kopieren Sie ihn sofort: Wir speichern nur einen Hashwert, deshalb wird er nur einmal angezeigt. Bewahren Sie ihn auf Ihrem Server auf, nicht in Browsern oder Apps.

Shell
export KENNMARQ_API_KEY="sk_test_…"

Testschlüssel haben ein eigenes monatliches Kontingent (100 Markierungen im Free-Plan, in kostenpflichtigen Plänen so viele wie das Live-Kontingent) und signieren mit einem Testzertifikat. Siehe Schlüssel, Berechtigungen und Umgebungen.

3. Bild markieren

Senden Sie eine PNG-, JPEG- oder WebP-Datei als Multipart-Formulardaten, bis 4 MB in der Anfrage selbst; eine größere, bis 25 MB, geht über einen Upload:

curl
curl https://api.kennmarq.com/v1/mark \
  -H "Authorization: Bearer $KENNMARQ_API_KEY" \
  -F file=@image.png \
  -F source=created \
  -F model="FLUX.1 schnell" \
  -F app_name="Acme Studio" \
  -D headers.txt \
  -o image.marked.png

Fügen Sie -F provider="Acme Inc." und -F app_version="2.1" hinzu, dann enthält die Markierung alle fünf Angaben der latenten Offenlegung, die Kalifornien verlangt; mit -F markets=eu,us-ca erhalten Sie einen Nachweis.

Songs (MP3, WAV, M4A) funktionieren genauso. Ein Clip (MP4) wird als Auftrag markiert: Der Aufruf antwortet mit 202 und der ID des Auftrags, und GET /v1/marks/{id} liefert den markierten Clip, sobald er fertig ist (Clips).

Der Body der Antwort ist die markierte Datei. headers.txt enthält, was Sie aufbewahren sollten:

headers.txt
HTTP/2 200
content-type: image/png
content-disposition: attachment; filename="image.marked.png"
x-mark-id: mk_4Q8oT1n6mWc2fLr0aZ9eYb
x-watermark-id: 1a2b3c4d5e6f7081
x-marks-used: 1
x-marks-limit: 1000
x-request-id: req_7Hc2kQm0Zt1L
x-ratelimit-limit: 10
x-ratelimit-remaining: 9
x-ratelimit-reset: 1792663260

4. Markierungen prüfen

Jede Software, die C2PA liest, etwa das Open-Source-Tool c2patool, zeigt das signierte Manifest an: den KI-Quelltyp, Ihr Modell und den Namen Ihrer App, die Wasserzeichen-Aktion und den Zeitstempel.

Shell
c2patool image.marked.png

Oder ziehen Sie es auf unser kostenloses Prüftool: Es liest beide Markierungen in Ihrem Browser und findet über das Wasserzeichen die Content Credentials einer Kopie, deren Metadaten entfernt wurden.

Bis unsere C2PA-Konformität und unser öffentlich vertrauenswürdiges Zertifikat vorliegen, zeigt C2PA-Software die Signatur als gültige Signatur eines unbekannten Unterzeichners an und unsere Zeitstempel als nicht vertrauenswürdig. Unsere Zertifikatsketten sind unter GET /v1/certificate öffentlich abrufbar.

5. Live gehen

Erstellen Sie für die Produktion einen Schlüssel in der Umgebung Live und beschränken Sie ihn mit einer IP-Allowlist auf Ihre Server. Live- und Testschlüssel werden auf getrennte Kontingente angerechnet, sodass Tests nie Markierungen der Produktion verbrauchen. Behalten Sie Ihre Nutzung im Blick: im Dashboard, im Header X-Marks-Used oder mit GET /v1/usage.

Nächste Schritte