Ein Bild, einen Song oder einen Clip markieren

POST https://api.kennmarq.com/v1/mark

Senden Sie ein Bild oder einen Song, und Sie erhalten die Datei mit einem unsichtbaren Wasserzeichen und einem signierten C2PA-Manifest mit Zeitstempel zurück. Senden Sie einen Clip, und Sie erhalten einen Auftrag und, sobald er fertig ist, den markierten Clip über GET /v1/marks/{id}. Ein Bild zählt eine Markierung, ein Song fünf je angefangene Minute, ein Clip fünf je angefangene Sekunde. Erfordert einen Schlüssel mit der Berechtigung mark.

Anfrage

multipart/form-data mit diesen Feldern. Bei Textfeldern werden Leerzeichen am Anfang und Ende entfernt; Flags akzeptieren true/false (oder 1/0, on/off, yes/no).

Geplante Optionen (metadata, webhook, ai_disclosure, categorize, describe, Markieren per url) werden mit 400 option_not_available abgelehnt statt ignoriert, damit eine Datei nie so wirkt, als trüge sie etwas, das sie nicht trägt.

Beispiel

curl https://api.kennmarq.com/v1/mark \
  -H "Authorization: Bearer $KENNMARQ_API_KEY" \
  -F file=@render.jpg \
  -F source=created \
  -F provider="Acme Inc." \
  -F model="FLUX.1 schnell" \
  -F model_version="1.0" \
  -F app_name="Acme Studio" \
  -F app_version="2.1" \
  -F output_format=webp \
  -D headers.txt \
  -o render.marked.webp

import { readFile, writeFile } from "node:fs/promises";

const form = new FormData();
form.append("file", new Blob([await readFile("render.png")], { type: "image/png" }), "render.png");
form.append("source", "created");
form.append("model", "FLUX.1 schnell");

const res = await fetch("https://api.kennmarq.com/v1/mark", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.KENNMARQ_API_KEY}` },
  body: form,
});
if (!res.ok) throw new Error((await res.json()).error.message);
await writeFile("render.marked.png", Buffer.from(await res.arrayBuffer()));
console.log(res.headers.get("x-mark-id"), res.headers.get("x-marks-used"));

import os, requests

with open("render.png", "rb") as f:
    res = requests.post(
        "https://api.kennmarq.com/v1/mark",
        headers={"Authorization": f"Bearer {os.environ['KENNMARQ_API_KEY']}"},
        files={"file": ("render.png", f, "image/png")},
        data={"source": "created", "model": "FLUX.1 schnell"},
        timeout=60,
    )
res.raise_for_status()
open("render.marked.png", "wb").write(res.content)
print(res.headers["X-Mark-Id"], res.headers["X-Marks-Used"])

Antwort

200 mit der markierten Datei als Body und diesen Headern:

Sichtbare Kennzeichnungen

Mit eingeschaltetem label zeichnen wir das EU-Symbol aus dem Verhaltenskodex für KI-generierte Inhalte in das Bild oder in jedes Einzelbild des Clips: das großgeschriebene „AI“ und dazu GENERATED bei created oder MODIFIED bei composite und edited, wie es Anhang 1 des Kodex zeigt. Es wird vor dem Wasserzeichen eingefügt, sodass Wasserzeichen und Signatur es abdecken, und das Manifest hält es fest (eine Aktion c2pa.edited und eine Assertion com.kennmarq.label): Das Prüftool und /v1/verify zeigen es an.

Das Symbol sitzt standardmäßig oben rechts, wo es das Beispiel des Kodex platziert, in der Größe nach der kürzeren Seite bemessen, und bei einem Clip auf jedem Einzelbild, wie es der Kodex anregt. auto wählt Schwarz oder Weiß nach den Pixeln dahinter, sodass es auf jedem Hintergrund lesbar bleibt. Ein Bild, das für die Pillenform zu schmal ist, erhält das runde „AI“-Symbol.

deepfake=true schaltet die Kennzeichnung ein, und die Märkte bestimmen, wann sie eingeschaltet bleiben muss: in Indien immer, in der EU und in Südkorea bei Deepfakes. Der Nachweis führt sie für jeden Markt auf.

curl https://api.kennmarq.com/v1/mark \
  -H "Authorization: Bearer $KENNMARQ_API_KEY" \
  -F file=@portrait.jpg \
  -F source=edited \
  -F app_name="Acme Studio" \
  -F markets=eu,in \
  -F deepfake=true \
  -o portrait.marked.jpg

Dieselbe Kennzeichnung in Ihrer eigenen Oberfläche

Neben einer Datei, in einem Feed oder dort, wo ein Bild sie nicht tragen kann, zeigen Sie dieselbe Kennzeichnung mit unserer Webkomponente an: ein Skript, keine Anfragen, keine Cookies, und Screenreader lesen sie als „AI-generated content“ vor. Genau diese Art von Offenlegung verlangt der Kodex neben künstlerischen Werken und Südkorea für Inhalte, die innerhalb Ihres Dienstes angezeigt werden.

<script src="https://kennmarq.com/label.js" defer></script>

<kennmarq-label kind="generated" lang="en" theme="dark" size="24"></kennmarq-label>

kind: generated oder modified. lang: en, ko oder zh. theme: dark, light, dark-translucent oder light-translucent. size: die Höhe in Pixeln. href macht die Kennzeichnung zu einem Link, etwa dorthin, wo sich die Datei prüfen lässt. Die Komponente steht unter der MIT-Lizenz: Kopieren Sie sie in Ihre App, wenn Sie sie lieber nicht von uns laden.

Songs

MP3, WAV oder M4A, bis 15 Minuten. Der Song kommt im selben Aufruf zurück, in seinem eigenen Format (oder dem, das output_format nennt), mit seiner Abtastrate, seinen Kanälen und seinen Text-Tags; Coverbilder werden nicht übernommen. Sein Ton trägt die AudioSeal-Markierung von Meta, so unter die Musik geformt, dass niemand sie hört, und sein Manifest wird wie das eines Bildes signiert und mit einem Zeitstempel versehen. Die 16 Bit von AudioSeal sagen, dass die Datei von uns markiert wurde, nicht welche Datei: Die Content Credentials eines Songs stecken in seinem Manifest, und ein Song hat keine X-Watermark-Id.

Die Markierung wird aus der codierten Datei zurückgelesen: Gelingt das, gibt das Manifest an, dass die Datei sie trägt (X-Audio-Watermark: claimed). In einer sehr leisen oder stillen Aufnahme gibt es nichts, worunter sie sich verbergen ließe; die Datei wird dann ohne diese Angabe signiert (unclaimed). Ein Song, der länger ist, als Ihre in diesem Monat verbleibenden Markierungen reichen, wird vor jeder Verarbeitung mit 402 quota_exceeded abgelehnt.

Clips

MP4 (oder QuickTime), bis 4.500 Einzelbilder (2,5 Minuten bei 30 Bildern pro Sekunde, 75 Sekunden bei 60, 5 Minuten bei 15), 1920x1080 im Quer- oder Hochformat, 60 Bilder pro Sekunde, 1 GB über einen Upload: so viel, wie wir innerhalb der Laufzeit eines Auftrags markieren können. Ihr Plan markiert einige Clips gleichzeitig (gleichzeitige Clips). Ein Clip wird als Auftrag markiert: Der Aufruf antwortet sofort mit 202 und der ID der Markierung, und GET /v1/marks/{id} zeigt an, wann er fertig ist, mit einem Link zum Herunterladen. Endpunkte, die Sie im Dashboard hinzufügen, erhalten mark.completed oder mark.failed (Webhooks).

{ "object": "mark", "id": "mk_…", "status": "running", "kind": "clip",
  "created_at": "2026-11-12T10:00:00.000Z", "url": "https://api.kennmarq.com/v1/marks/mk_…" }

Jedes Einzelbild trägt das Wasserzeichen Video Seal von Meta, mit einer zufälligen ID wie bei einem Bild (watermark_id): Sie führt zu den dauerhaften Content Credentials des Clips, wenn seine Metadaten entfernt wurden. Sein Ton trägt AudioSeal, wie bei einem Song. Der Clip kommt als H.264 in MP4 zurück, aufrecht (die Drehung eines Smartphones wird auf die Pixel angewendet), in derselben Größe, mit denselben Bildzeitpunkten und demselben Ton, signiert und mit Zeitstempel. Bevor er ausgeliefert wird, wird die ID des Wasserzeichens aus 64 seiner Einzelbilder zurückgelesen; ein Clip, aus dem sie sich nicht zurücklesen lässt, schlägt fehl, wie ein Bild. Für unsere Untergrenze werden 12 Einzelbilder jedes Clips gelesen, mit check zusätzlich für Ihre Richtlinie (zwei Markierungen je Einzelbild); ein blockiertes Einzelbild lässt den Auftrag fehlschlagen, mit der Antwort zu diesem Einzelbild in safety.

Was wir vor der Antwort prüfen

Im Zweifel schlagen wir fehl (Fail-closed): Eine Datei geht nur zurück, wenn sie wie verlangt markiert wurde. Vor der Antwort liest der Markierungsdienst die signierte Datei zurück und validiert ihr Manifest und ihren Zeitstempel; dann prüfen wir, dass die Antwort zu dieser Markierung gehört, zu dieser Umgebung, im verlangten Format, mit genau den Bytes, die der Markierungsdienst beschrieben hat. Stimmt etwas nicht, erhalten Sie 502 mark_failed und keine Datei, und die Markierung wird nicht gezählt.

Die Sicherheitsprüfung

Jedes Bild, das wir markieren, wird an unserer eigenen Untergrenze gemessen, was auch immer Sie senden: Explizite Inhalte mit einer Person, die dem Anschein nach ein Kind ist, werden nie markiert, und der Aufruf antwortet mit 422 content_blocked. Ist check gesetzt, werden die Datei und die Eingabe zusätzlich nach Ihrer Richtlinie geprüft. Bei einem Clip werden 12 Einzelbilder gelesen. Eine Blockierung antwortet mit der Prüfung in safety, und picture gibt an, welches Bild es war:

{
  "error": { "code": "content_blocked", "message": "The safety check blocked this picture, so nothing was marked. See \"safety\" for why.", "request_id": "req_…" },
  "safety": { "object": "safety_check", "policy": "ai-act", "verdict": "block", "reason": "sexual_apparent_minor",
              "nudity": { "label": "explicit", "score": 0.98 }, "apparent_minor": true, "realistic_face": true,
              "picture": "file", … }
}

Ein blockierter Aufruf zählt die durchgeführten Prüfungen, nicht die Markierung. Eine Blockierung allein durch unsere Untergrenze, bei ausgeschaltetem check, zählt nichts.

Fehler

Fehler-Bodys folgen dem gemeinsamen Format.

Datenschutz

Wir erfassen von jeder Markierung die ID, die Wasserzeichen-ID, den SHA-256 und die Größen, nie die Datei, ihren Namen oder ihren Inhalt. Die markierte Datei eines Clips liegt einen Tag für Sie bereit und wird dann gelöscht. Markierungen geben an, wie eine Datei entstanden ist, nie, wer sie erstellt hat oder mit welchem Prompt. Die Antwort einer Sicherheitsprüfung wird nie in die Markierungen der Datei geschrieben, und von einem blockierten Bild wird nichts aufbewahrt. Ein Upload wird gelöscht, sobald der Aufruf ihn verwendet hat.