Unmarkr logoUnmarkr

API de suppression de filigranes IA : exemples curl, Python et Node.js

· 5 min de lecture

Si vous hésitez encore à passer par une API, commencez par notre présentation de la suppression en masse. Ici, c’est le code. L’API Unmarkr a un seul endpoint et deux modes : standard retire les métadonnées et répond tout de suite, full retire aussi le logo visible et SynthID dans une tâche en arrière-plan que vous interrogez.

Ce qu’il vous faut

  • Une clé API, à créer dans votre tableau de bord. Elle commence par unmarkr_live_ et se passe dans un en-tête Authorization: Bearer.
  • Des crédits. Un nettoyage standard coûte 1 crédit, une suppression complète 4. Si une suppression complète échoue, les crédits reviennent automatiquement.
  • Des fichiers PNG, JPG ou WebP, jusqu’à 25 Mo.

Retirer les métadonnées (mode standard)

C’est l’appel le moins cher. Il retire les Content Credentials C2PA, l’étiquette « Made with AI » et les données EXIF/XMP, ne touche pas aux pixels, et renvoie l’image nettoyée dans le corps de la réponse.

curl -X POST https://unmarkr.io/api/remove \
  -H "Authorization: Bearer $UNMARKR_KEY" \
  -F image=@photo.png \
  -F mode=standard \
  -o photo-propre.png

L’en-tête X-Unmarkr-Removed de la réponse liste ce qui a été retiré, ou indique none si le fichier était déjà propre.

Retirer aussi SynthID (mode full)

Le mode full prend de 15 à 90 secondes, donc la requête n’attend pas la fin. Vous recevez tout de suite un 202 avec un identifiant de tâche. Interrogez /api/jobs/<id> jusqu’au statut done, puis téléchargez l’image sur /api/jobs/<id>/result. La même clé sert pour les trois appels.

Python

import os, time, requests

API = "https://unmarkr.io"
H = {"Authorization": "Bearer " + os.environ["UNMARKR_KEY"]}

with open("gemini.png", "rb") as f:
    r = requests.post(API + "/api/remove", headers=H,
                      files={"image": f}, data={"mode": "full"})
r.raise_for_status()
job = r.json()  # {"jobId", "status": "processing", "poll", "result"}

while True:
    s = requests.get(API + job["poll"], headers=H).json()
    if s["status"] == "done":
        break
    if s["status"] == "error":
        raise RuntimeError(s.get("error"))  # crédits remboursés
    time.sleep(5)

out = requests.get(API + job["result"], headers=H)
with open("gemini-propre.png", "wb") as f:
    f.write(out.content)

Node.js (18 ou plus)

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

const API = "https://unmarkr.io";
const headers = { Authorization: "Bearer " + process.env.UNMARKR_KEY };

const form = new FormData();
form.append("image", new Blob([await readFile("gemini.png")]), "gemini.png");
form.append("mode", "full");

const res = await fetch(API + "/api/remove", { method: "POST", headers, body: form });
const job = await res.json();

let status = "processing";
while (status === "processing") {
  await new Promise((r) => setTimeout(r, 5000));
  const s = await (await fetch(API + job.poll, { headers })).json();
  status = s.status;
  if (status === "error") throw new Error(s.error); // crédits remboursés
}

const out = await fetch(API + job.result, { headers });
await writeFile("gemini-propre.png", Buffer.from(await out.arrayBuffer()));

Les erreurs que vous rencontrerez vraiment

  • 401 : clé absente, mal copiée ou révoquée.
  • 402 : pas assez de crédits. Le mode full en demande 4.
  • 413 : le fichier dépasse 25 Mo.
  • 429 : vous avez dépassé la limite de débit de la clé. Attendez le nombre de secondes indiqué dans Retry-After. L’en-tête RateLimit de chaque réponse vous dit où vous en êtes.

Chaque champ est décrit dans la documentation de l’API, et une spécification OpenAPI est disponible si vous préférez générer un client. N’envoyez que des images qui vous appartiennent ou que vous avez le droit de modifier.

Essayez d'abord une image dans le navigateur

Déposez une image dans Unmarkr pour voir ce qu'elle contient avant de brancher l'API. L'analyse est gratuite.

Analyser une image — gratuit