API de filigrane d'images
pour développeurs

Le filigrane manuel fonctionne pour une poignée d'images, mais il ne passe pas à l'échelle. Si vous construisez une plateforme qui gère des fichiers utilisateurs, si vous gérez une boutique e-commerce avec des photos de produits, ou si vous administrez un portfolio photo avec des centaines d'images, vous avez besoin d'automatisation. Une API de filigrane d'images vous permet d'ajouter des filigranes dans votre pipeline existant - pas d'étapes manuelles, pas de logiciel de bureau, pas de goulot d'étranglement humain.

Avec l'API Markly, le filigrane se résume à un seul appel HTTP. Envoyez une image, spécifiez vos paramètres de filigrane et récupérez le résultat en quelques secondes. Elle s'intègre dans les pipelines CI/CD, les hooks CMS, les backends d'applications mobiles et les scripts de traitement par lot. Combinée à une solide stratégie de protection photo, le filigrane par API est le moyen le plus fiable de protéger du contenu visuel à grande échelle.

L'API Markly est une API REST qui accepte les données multipart form. Vous envoyez une image avec les paramètres de filigrane et vous recevez l'image filigranée en retour. L'authentification utilise des clés API passées dans l'en-tête Authorization.

L'API fournit quatre endpoints principaux :

Tous les endpoints acceptent les images JPEG, PNG et WebP jusqu'à 25 Mo. Les réponses retournent l'image traitée directement dans le même format, ou un ZIP pour les requêtes par lot.

Voici des exemples fonctionnels pour les langages les plus courants. Remplacez YOUR_API_KEY par votre véritable clé depuis le tableau de bord développeur.

curl -X POST https://www.markly.cloud/api/v1/watermark/text \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "[email protected]" \
  -F "text=© 2026 Ma Marque" \
  -F "font_size=24" \
  -F "opacity=0.5" \
  -F "position=bottom-right" \
  -o filigrane.jpg

import requests

response = requests.post(
    "https://www.markly.cloud/api/v1/watermark/text",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    files={"image": open("photo.jpg", "rb")},
    data={
        "text": "© 2026 Ma Marque",
        "font_size": 24,
        "opacity": 0.5,
        "position": "bottom-right",
    },
)

with open("filigrane.jpg", "wb") as f:
    f.write(response.content)

import fs from "fs";
import FormData from "form-data";
import axios from "axios";

const form = new FormData();
form.append("image", fs.createReadStream("photo.jpg"));
form.append("text", "© 2026 Ma Marque");
form.append("font_size", "24");
form.append("opacity", "0.5");
form.append("position", "bottom-right");

const res = await axios.post(
  "https://www.markly.cloud/api/v1/watermark/text",
  form,
  { headers: { Authorization: "Bearer YOUR_API_KEY", ...form.getHeaders() },
    responseType: "arraybuffer" }
);

fs.writeFileSync("filigrane.jpg", res.data);

L'API est disponible sur tous les plans Markly, y compris l'offre gratuite. L'utilisation est mesurée en crédits - un crédit par image traitée (texte ou logo). Les requêtes par lot consomment un crédit par image dans le lot.

Tous les plans payants incluent l'endpoint de filigrane logo, le traitement par lot et les statistiques d'utilisation. Les crédits non utilisés sur les abonnements sont reportés pendant un mois. Les limites de débit sont par clé API, pas par IP.

Markly fournit également un serveur Model Context Protocol (MCP) qui permet aux assistants IA et aux agents de filigraner des images à votre place. Si vous utilisez des outils comme Claude, Cursor ou des agents LLM personnalisés, le serveur MCP expose les mêmes fonctionnalités de filigrane via une interface d'outils standardisée.

Le serveur MCP prend en charge les filigranes texte, les filigranes logo et le traitement par lot - les mêmes fonctionnalités que l'API REST. Consultez la documentation développeur pour les instructions d'installation et la configuration JSON du MCP.

Vous pouvez commencer à utiliser l'API de filigrane en trois étapes :

La référence complète des endpoints, la documentation des paramètres et les codes d'erreur sont disponibles dans la documentation développeur.