Zum Hauptinhalt springen
Entwickler-Leitfaden

Wasserzeichen-API für Entwickler

Fügen Sie Bildern programmatisch Wasserzeichen hinzu - mit der Markly API. Ob Sie ein einzelnes Bild schützen oder Tausende im Stapel verarbeiten möchten: Die API lässt sich mit einfachen HTTP-Aufrufen in jeden Workflow integrieren.

Lesezeit: 5 Min. Aktualisiert am 4. März 2026
1

Warum eine API für Wasserzeichen nutzen?

Manuelles Wasserzeichen funktioniert für eine Handvoll Bilder, skaliert aber nicht. Wenn Sie eine Plattform mit Nutzer-Uploads betreiben, einen Online-Shop mit Produktfotos führen oder ein Fotografie-Portfolio mit Hunderten von Bildern verwalten, brauchen Sie Automatisierung. Eine Wasserzeichen-API ermöglicht es Ihnen, Wasserzeichen als Teil Ihrer bestehenden Pipeline hinzuzufügen - ohne manuelle Schritte, ohne Desktop-Software, ohne menschlichen Engpass.

Mit der Markly API wird das Wasserzeichen zu einem einzigen HTTP-Aufruf. Laden Sie ein Bild hoch, legen Sie Ihre Wasserzeichen-Einstellungen fest und erhalten Sie das Ergebnis in Sekunden zurück. Die API passt in CI/CD-Pipelines, CMS-Hooks, Mobile-App-Backends und Batch-Skripte. Kombiniert mit einer soliden Strategie zum Schutz Ihrer Fotos ist API-gestütztes Wasserzeichen der zuverlässigste Weg, visuelle Inhalte in großem Umfang zu schützen.

Wann eine API sinnvoll ist:

  • Automatisierung: Bilder beim Upload automatisch mit Wasserzeichen versehen - ohne manuellen Eingriff
  • Skalierung: Hunderte oder Tausende Bilder pro Tag mit Batch-Endpunkten verarbeiten
  • Integration: In jeden Stack einbinden - PHP, Python, Node.js, Ruby, Go oder einfaches cURL
  • Konsistenz: Jedes Bild erhält die gleiche Wasserzeichen-Platzierung, Schriftart und Deckkraft
2

So funktioniert die Markly API

Die Markly API ist eine REST API, die multipart-Formulardaten akzeptiert. Sie senden ein Bild zusammen mit den Wasserzeichen-Parametern und erhalten das fertige Bild zurück. Die Authentifizierung erfolgt über API-Schlüssel im Authorization-Header.

Die API stellt vier Hauptendpunkte bereit:

API-Endpunkte:

  • POST /api/v1/watermark/text - Fügt einem einzelnen Bild ein Text-Wasserzeichen hinzu. Parameter umfassen Textinhalt, Schriftart, Größe, Farbe, Deckkraft, Position, Rotation und Kachelung
  • POST /api/v1/watermark/logo - Überlagert ein Logo als Wasserzeichen. Steuern Sie Größe, Deckkraft, Position und Abstand
  • POST /api/v1/watermark/batch - Senden Sie mehrere Bilder in einer Anfrage. Alle Bilder erhalten die gleichen Wasserzeichen-Einstellungen. Rückgabe als ZIP-Archiv
  • GET /api/v1/usage - Prüfen Sie Ihr aktuelles Credit-Guthaben, Nutzungsverlauf und Rate-Limit-Status

Alle Endpunkte akzeptieren JPEG-, PNG- und WebP-Bilder bis 25 MB. Antworten liefern das verarbeitete Bild direkt im gleichen Format zurück, oder ein ZIP bei Batch-Anfragen.

3

Codebeispiele

Hier sind funktionierende Beispiele für die gängigsten Programmiersprachen. Ersetzen Sie YOUR_API_KEY durch Ihren echten Schlüssel aus dem Entwickler-Dashboard.

cURL

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

Python

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 Meine Marke",
        "font_size": 24,
        "opacity": 0.5,
        "position": "bottom-right",
    },
)

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

Node.js

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 Meine Marke");
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("wasserzeichen.jpg", res.data);
4

Tarife und Preise

Die API ist in jedem Markly-Tarif verfügbar, einschließlich des kostenlosen Tarifs. Die Nutzung wird in Credits gemessen - ein Credit pro verarbeitetem Bild (Text oder Logo). Batch-Anfragen verbrauchen einen Credit pro Bild im Stapel.

API-Tarife:

  • Anonym (kostenlos): 10 Bilder/Tag, kein API-Schlüssel nötig, Rate Limit von 5 Anfragen/Minute
  • Credit-Pakete: Credits nach Bedarf kaufen. Pakete mit 100, 500 oder 2.000 Credits ohne Ablaufdatum
  • Pro (9 $/Monat): 1.000 Credits/Monat, Zugang zum Batch-Endpunkt, 30 Anfragen/Minute, priorisierte Verarbeitung
  • Business (29 $/Monat): 10.000 Credits/Monat, Batch-Endpunkt, 120 Anfragen/Minute, dedizierter Support, benutzerdefinierte Wasserzeichen-Vorlagen

Alle kostenpflichtigen Tarife beinhalten den Logo-Wasserzeichen-Endpunkt, Stapelverarbeitung und Nutzungsanalysen. Nicht verbrauchte Credits bei Abo-Tarifen werden einen Monat übertragen. Rate Limits gelten pro API-Schlüssel, nicht pro IP.

5

MCP Server für KI-Agenten

Markly bietet auch einen Model Context Protocol (MCP) Server, mit dem KI-Assistenten und Agenten Bilder in Ihrem Auftrag mit Wasserzeichen versehen können. Wenn Sie Tools wie Claude, Cursor oder eigene LLM-Agenten nutzen, stellt der MCP Server die gleichen Wasserzeichen-Funktionen über eine standardisierte Tool-Schnittstelle bereit.

Der MCP Server unterstützt Text-Wasserzeichen, Logo-Wasserzeichen und Stapelverarbeitung - die gleichen Funktionen wie die REST API. Weitere Informationen zur Einrichtung und die MCP-Konfigurations-JSON finden Sie in der Entwickler-Dokumentation.

6

Erste Schritte

Sie können die Wasserzeichen-API in drei Schritten nutzen:

Schnellstart:

  • Schritt 1 - API-Schlüssel erhalten: Registrieren Sie sich bei Markly und generieren Sie einen API-Schlüssel in Ihrem Dashboard. Der kostenlose Tarif bietet 10 Bilder/Tag ohne Kreditkarte
  • Schritt 2 - Ersten Aufruf testen: Verwenden Sie das cURL-Beispiel oben, um ein Testbild mit Wasserzeichen zu versehen. Sie sollten innerhalb weniger Sekunden ein fertiges JPEG erhalten
  • Schritt 3 - Integrieren: Binden Sie den API-Aufruf in Ihre Upload-Pipeline, Ihr Build-Skript oder Ihr Anwendungs-Backend ein. Nutzen Sie den Batch-Endpunkt für Workflows mit hohem Volumen

Vollständige Endpunkt-Referenz, Parameter-Dokumentation und Fehlercodes finden Sie in der Entwickler-Dokumentation.

Kompletter Schutz

Kombinieren Sie API-Wasserzeichen mit Urheberrechtsregistrierung. Versehen Sie Ihre Bilder über die Markly API mit Wasserzeichen und registrieren Sie die Originale bei Copyright01 für einen zeitgestempelten Eigentumsnachweis mit SHA-256-Verifizierung.

Schutz im großen Maßstab

Automatisieren Sie Wasserzeichen mit der API und sichern Sie sich den rechtlichen Nachweis durch Urheberrechtsregistrierung.

Markly

Versehen Sie Bilder programmatisch mit Wasserzeichen über eine einfache REST API. Kostenloser Tarif, Stapelverarbeitung und Codebeispiele inklusive.

API jetzt nutzen
Copyright01

Registrieren Sie Ihre Originale mit einem zeitgestempelten Zertifikat als rechtlichen Eigentumsnachweis.

Zertifikat registrieren

API jetzt nutzen

Kostenloser Tarif, sofortige Einrichtung. Wasserzeichen per HTTP-Aufruf hinzufügen.

API-Dokumentation ansehen