API filigran pentru imagini
pentru dezvoltatori

Filigranarea manuală funcționează pentru câteva imagini, dar nu se scalează. Dacă construiești o platformă care gestionează încărcările utilizatorilor, administrezi un magazin online cu fotografii de produse sau gestionezi un portofoliu de fotografie cu sute de imagini, ai nevoie de automatizare. Un API de filigranare îți permite să adaugi filigrane ca parte a procesului existent - fără pași manuali, fără software desktop, fără blocaj uman.

Cu API-ul Markly, filigranarea devine un singur apel HTTP. Încarcă o imagine, specifică setările de filigran și primești rezultatul în câteva secunde. Se integrează în pipeline-uri CI/CD, hook-uri CMS, backend-uri pentru aplicații mobile și scripturi de procesare în lot. Combinat cu o strategie solidă de protecție a fotografiilor, filigranarea prin API este cea mai fiabilă metodă de a proteja conținutul vizual la scară largă.

API-ul Markly este un REST API care acceptă date multipart form. Trimiți o imagine împreună cu parametrii de filigran și primești înapoi imaginea filigranată. Autentificarea folosește chei API transmise în header-ul Authorization.

API-ul oferă patru endpoint-uri principale:

Toate endpoint-urile acceptă imagini JPEG, PNG și WebP de până la 25 MB. Răspunsurile returnează imaginea procesată direct în același format, sau un ZIP pentru cererile de lot.

Iată exemple funcționale pentru cele mai utilizate limbaje. Înlocuiește YOUR_API_KEY cu cheia ta reală din panoul pentru dezvoltatori.

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

with open("filigran.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 Marca Mea");
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("filigran.jpg", res.data);

API-ul este disponibil pe orice plan Markly, inclusiv cel gratuit. Utilizarea se măsoară în credite - un credit per imagine procesată (text sau logo). Cererile de lot consumă un credit per imagine din lot.

Toate planurile plătite includ endpoint-ul de filigran logo, procesarea în lot și analiza utilizării. Creditele neutilizate la planurile cu abonament se reportează pentru o lună. Limitele de rată sunt per cheie API, nu per IP.

Markly oferă și un server Model Context Protocol (MCP) care permite asistenților și agenților AI să filigraneze imagini în numele tău. Dacă folosești instrumente precum Claude, Cursor sau agenți LLM personalizați, serverul MCP expune aceleași capacități de filigranare printr-o interfață standardizată.

Serverul MCP suportă filigrane text, filigrane logo și procesare în lot - aceleași funcționalități disponibile prin REST API. Consultă documentația pentru dezvoltatori pentru instrucțiuni de configurare și JSON-ul de configurare MCP.

Poți începe să folosești API-ul de filigranare în trei pași:

Referința completă a endpoint-urilor, documentația parametrilor și codurile de eroare sunt disponibile în documentația pentru dezvoltatori.