Watermerk API
voor ontwikkelaars

Handmatig watermerken werkt voor een handvol afbeeldingen, maar schaalt niet. Als je een platform bouwt dat uploads verwerkt, een webshop runt met productfoto's, of een fotografieportfolio beheert met honderden afbeeldingen, heb je automatisering nodig. Een watermerk API laat je watermerken toevoegen als onderdeel van je bestaande pipeline - geen handmatige stappen, geen desktopsoftware, geen menselijke bottleneck.

Met de Markly API wordt watermerken een enkele HTTP-aanroep. Upload een afbeelding, geef je watermerkinstellingen op en ontvang het resultaat binnen enkele seconden. Het past in CI/CD-pipelines, CMS-hooks, mobiele app-backends en batchscripts. Gecombineerd met een solide strategie voor fotobescherming is API-gestuurd watermerken de meest betrouwbare manier om visuele content op schaal te beschermen.

De Markly API is een REST API die multipart form data accepteert. Je stuurt een afbeelding samen met watermerkparameters en krijgt de gewatermerkte afbeelding terug. Authenticatie werkt via API-sleutels in de Authorization-header.

De API biedt vier hoofdendpoints:

Alle endpoints accepteren JPEG-, PNG- en WebP-afbeeldingen tot 25 MB. Antwoorden retourneren de verwerkte afbeelding direct in hetzelfde formaat, of een ZIP bij batchverzoeken.

Hieronder vind je werkende voorbeelden voor de meest gebruikte programmeertalen. Vervang YOUR_API_KEY door je daadwerkelijke sleutel uit het ontwikkelaarsdashboard.

curl -X POST https://www.markly.cloud/api/v1/watermark/text \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "[email protected]" \
  -F "text=© 2026 Mijn Merk" \
  -F "font_size=24" \
  -F "opacity=0.5" \
  -F "position=bottom-right" \
  -o watermerk.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 Mijn Merk",
        "font_size": 24,
        "opacity": 0.5,
        "position": "bottom-right",
    },
)

with open("watermerk.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 Mijn Merk");
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("watermerk.jpg", res.data);

De API is beschikbaar bij elk Markly-abonnement, inclusief het gratis niveau. Gebruik wordt gemeten in credits - een credit per verwerkte afbeelding (tekst of logo). Batchverzoeken verbruiken een credit per afbeelding in de batch.

Alle betaalde abonnementen omvatten het logo-watermerk-endpoint, batchverwerking en gebruiksanalyses. Ongebruikte credits bij maandabonnementen worden een maand meegenomen. Rate limits gelden per API-sleutel, niet per IP-adres.

Markly biedt ook een Model Context Protocol (MCP) server waarmee AI-assistenten en agents namens jou afbeeldingen kunnen watermerken. Als je tools zoals Claude, Cursor of aangepaste LLM-agents gebruikt, stelt de MCP-server dezelfde watermerkfunctionaliteiten beschikbaar via een gestandaardiseerde toolinterface.

De MCP-server ondersteunt tekstwatermerken, logowatermerken en batchverwerking - dezelfde functies als de REST API. Bekijk de ontwikkelaarsdocumentatie voor installatie-instructies en de MCP-configuratie-JSON.

Je kunt de watermerk API in drie stappen gaan gebruiken:

Volledige endpointreferentie, parameterdocumentatie en foutcodes zijn beschikbaar in de ontwikkelaarsdocumentatie.