API znaku wodnego
dla deweloperow

Reczne znakowanie wodne sprawdza sie przy kilku zdjeciach, ale nie skaluje sie. Jesli budujesz platforme obslugujaca przesylanie plikow przez uzytkownikow, prowadzisz sklep internetowy ze zdjeciami produktow lub zarzadzasz portfolio fotograficznym z setkami zdjec, potrzebujesz automatyzacji. API znaku wodnego pozwala dodawac znaki w ramach istniejacego procesu - bez recznych krokow, bez oprogramowania desktopowego, bez waskiego gardla w postaci czlowieka.

Dzieki API Markly znakowanie wodne sprowadza sie do jednego wywolania HTTP. Przeslij zdjecie, okresl ustawienia znaku wodnego i otrzymaj wynik w kilka sekund. Pasuje do pipeline CI/CD, hookow CMS, backendow aplikacji mobilnych i skryptow wsadowych. W polaczeniu ze solidna strategia ochrony zdjec, znakowanie wodne przez API jest najskuteczniejszym sposobem ochrony tresci wizualnych na duza skale.

API Markly to REST API, ktore przyjmuje dane w formacie multipart form data. Wysylasz zdjecie wraz z parametrami znaku wodnego i otrzymujesz oznaczone zdjecie. Uwierzytelnianie odbywa sie za pomoca kluczy API przesylanych w naglowku Authorization.

API udostepnia cztery glowne endpointy:

Wszystkie endpointy akceptuja pliki JPEG, PNG i WebP do 25 MB. Odpowiedzi zwracaja przetworzone zdjecie bezposrednio w tym samym formacie lub archiwum ZIP dla zapytan wsadowych.

Ponizej znajdziesz gotowe przyklady dla najpopularniejszych jezykow. Zastap YOUR_API_KEY swoim kluczem z panelu dewelopera.

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

with open("znak-wodny.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 Moja Marka");
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("znak-wodny.jpg", res.data);

API jest dostepne w kazdym planie Markly, w tym w darmowym. Uzycie mierzone jest w kredytach - jeden kredyt za przetworzone zdjecie (tekst lub logo). Zapytania wsadowe zuzyja jeden kredyt za kazde zdjecie w partii.

Wszystkie platne plany obejmuja endpoint znaku wodnego z logo, przetwarzanie wsadowe i analityke uzycia. Niewykorzystane kredyty w planach subskrypcyjnych przenosza sie na jeden miesiac. Limity zapytan dotycza klucza API, a nie adresu IP.

Markly oferuje rowniez serwer Model Context Protocol (MCP), ktory pozwala asystentom i agentom AI dodawac znaki wodne do zdjec w Twoim imieniu. Jesli korzystasz z narzedzi takich jak Claude, Cursor czy wlasnych agentow LLM, serwer MCP udostepnia te same funkcje znakowania wodnego przez ustandaryzowany interfejs narzedziowy.

Serwer MCP obsluguje znaki wodne tekstowe, z logo oraz przetwarzanie wsadowe - te same funkcje, ktore sa dostepne przez REST API. Szczegoly konfiguracji i plik JSON MCP znajdziesz w dokumentacji dewelopera.

Mozesz zaczac korzystac z API znaku wodnego w trzech krokach:

Pelna dokumentacja endpointow, opis parametrow i kody bledow sa dostepne w dokumentacji dewelopera.