Marquer une image, un morceau ou une vidéo

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

Envoyez une image ou un morceau : le fichier vous est renvoyé avec un filigrane invisible et un manifeste C2PA signé et horodaté. Envoyez une vidéo : vous obtenez une tâche, puis la vidéo marquée via GET /v1/marks/{id} une fois la tâche terminée. Une image compte un marquage, un morceau cinq par minute entamée, une vidéo cinq par seconde entamée. Nécessite une clé avec la portée mark.

Requête

multipart/form-data, avec les champs ci-dessous. Les espaces en début et en fin des champs texte sont supprimés ; les booléens acceptent true/false (ou 1/0, on/off, yes/no).

Les options prévues (metadata, webhook, ai_disclosure, categorize, describe, le marquage par url) sont refusées avec 400 option_not_available plutôt qu’ignorées : un fichier ne semble donc jamais porter quelque chose qu’il ne porte pas.

Exemple

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"])

Réponse

200, avec le fichier marqué comme corps, et ces en-têtes :

Mentions visibles

Avec label activé, nous incrustons l’icône de l’UE du code de bonne pratique sur les contenus générés par l’IA dans l’image ou dans chaque image de la vidéo : « AI » en capitales, avec GENERATED pour created, ou MODIFIED pour composite et edited, comme le montre son annexe 1. Elle est ajoutée avant le filigrane, de sorte que le filigrane et la signature la couvrent, et le manifeste l’enregistre (une action c2pa.edited et une assertion com.kennmarq.label) : le vérificateur et /v1/verify l’affichent.

Par défaut, elle se place dans le coin supérieur droit, là où la place l’exemple du code de bonne pratique, avec une taille calculée sur le petit côté, et sur chaque image d’une vidéo, comme le code l’encourage. auto choisit le noir ou le blanc selon les pixels situés derrière, pour qu’elle reste lisible sur n’importe quel fond. Une image trop étroite pour la pastille reçoit l’icône ronde « AI ».

deepfake=true l’active, et les marchés décident quand elle doit rester active : toujours pour l’Inde, pour les hypertrucages dans l’UE et en Corée du Sud. Le justificatif l’indique pour chaque marché.

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

La même mention dans votre propre interface

À côté d’un fichier, dans un fil d’actualité, ou là où une image ne peut pas la porter, affichez la même mention avec notre composant web : un seul script, aucune requête, aucun cookie, et les lecteurs d’écran l’annoncent comme « AI-generated content ». Le code de bonne pratique demande précisément ce type de mention à côté des œuvres artistiques, et la Corée du Sud pour les contenus affichés dans votre service.

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

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

kind : generated ou modified. lang : en, ko ou zh. theme : dark, light, dark-translucent ou light-translucent. size : sa hauteur en pixels. href en fait un lien, par exemple vers la page où le fichier peut être vérifié. Il est sous licence MIT : copiez-le dans votre application si vous préférez ne pas le charger depuis nos serveurs.

Morceaux

MP3, WAV ou M4A, jusqu’à 15 minutes. Le morceau vous revient dans le même appel, dans son propre format (ou celui qu’indique output_format), avec sa fréquence d’échantillonnage, ses canaux et ses tags texte ; la pochette n’est pas conservée. Son signal porte le marquage AudioSeal de Meta, modelé sous la musique pour que personne ne l’entende, et son manifeste est signé et horodaté comme celui d’une image. Les 16 bits d’AudioSeal indiquent que le fichier a été marqué par nous, pas de quel fichier il s’agit : les Content Credentials d’un morceau voyagent dans son manifeste, et un morceau n’a pas de X-Watermark-Id.

Le marquage est relu dans le fichier encodé : s’il se relit, le manifeste indique que le fichier le porte (X-Audio-Watermark: claimed). Dans un enregistrement très calme ou silencieux, il n’y a rien sous quoi le cacher ; le fichier est alors signé sans cette déclaration (unclaimed). Un morceau plus long que ce que permettent les marquages qu’il vous reste ce mois-ci est refusé avant tout traitement, avec 402 quota_exceeded.

Vidéos

MP4 (ou QuickTime), jusqu’à 4 500 images (2,5 minutes à 30 images par seconde, 75 secondes à 60, 5 minutes à 15), 1920x1080 dans un sens ou dans l’autre, 60 images par seconde et 1 Go via un envoi : ce que nous pouvons marquer dans le temps imparti à une tâche. Votre offre marque quelques vidéos à la fois (vidéos simultanées). Une vidéo est marquée sous forme de tâche : l’appel répond aussitôt 202 avec l’ID du marquage, et GET /v1/marks/{id} indique quand elle est prête, avec un lien pour la télécharger. Les endpoints que vous ajoutez dans le tableau de bord reçoivent mark.completed ou 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_…" }

Chaque image de la vidéo porte le filigrane Video Seal de Meta, avec un ID aléatoire comme pour une image fixe (watermark_id) : il mène aux Content Credentials durables de la vidéo quand ses métadonnées sont supprimées. Sa piste audio porte AudioSeal, comme un morceau. La vidéo vous revient en H.264 dans un MP4, à l’endroit (la rotation d’un téléphone est appliquée aux pixels), avec la même taille, les mêmes instants d’image et le même son, signée et horodatée. Avant son envoi, l’ID du filigrane est relu sur 64 de ses images ; une vidéo sur laquelle il ne se relit pas échoue, comme une image fixe. Notre socle de sécurité analyse 12 images de chaque vidéo, et avec check, votre politique aussi (deux marquages par image) ; une image bloquée fait échouer la tâche, avec la réponse pour cette image dans safety.

Ce que nous vérifions avant de répondre

En cas d’anomalie, nous échouons de manière sûre (fail closed) : un fichier n’est renvoyé que s’il a été marqué comme demandé. Avant de répondre, le marqueur relit le fichier signé et valide son manifeste et son horodatage ; nous vérifions ensuite que la réponse correspond bien à ce marquage, dans cet environnement, au format demandé, avec exactement les octets que le marqueur a décrits. Si quoi que ce soit cloche, vous recevez 502 mark_failed et aucun fichier, et le marquage n’est pas décompté.

Le contrôle de sécurité

Chaque image que nous marquons passe par notre propre socle, quoi que vous envoyiez : un contenu explicite montrant une personne qui paraît être un enfant n’est jamais marqué, et l’appel répond 422 content_blocked. Avec check renseigné, le fichier et l’entrée sont aussi contrôlés selon votre politique. Une vidéo est analysée sur 12 images. Un blocage renvoie le contrôle dans safety, et picture indique de quelle image il s’agissait :

{
  "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", … }
}

Un appel bloqué décompte les contrôles effectués, pas le marquage. Un blocage dû à notre seul socle, avec check désactivé, ne décompte rien.

Erreurs

Les corps d’erreur suivent le format commun.

Confidentialité

Nous enregistrons pour chaque marquage son ID, l’ID du filigrane, le SHA-256 et les tailles, jamais le fichier, son nom ni son contenu. Le fichier marqué d’une vidéo reste à votre disposition pendant une journée, puis il est supprimé. Les marquages indiquent comment un fichier a été créé, jamais qui l’a créé ni avec quel prompt. La réponse d’un contrôle de sécurité n’est jamais inscrite dans les marquages du fichier, et rien n’est conservé d’une image bloquée. Un envoi est supprimé dès que l’appel l’a utilisé.