API filigrana immagini
per sviluppatori

La filigrana manuale funziona per una manciata di immagini, ma non scala. Se stai costruendo una piattaforma che gestisce upload degli utenti, un e-commerce con foto di prodotti, o un portfolio fotografico con centinaia di immagini, hai bisogno di automazione. Un'API di filigrana ti permette di aggiungere watermark come parte della tua pipeline esistente - nessun passaggio manuale, nessun software desktop, nessun collo di bottiglia umano.

Con l'API Markly, la filigrana si riduce a una singola chiamata HTTP. Carica un'immagine, specifica le impostazioni del watermark, e ricevi il risultato in pochi secondi. Si integra facilmente in pipeline CI/CD, hook CMS, backend di app mobile e script batch. Combinata con una solida strategia di protezione foto, la filigrana via API è il modo più affidabile per proteggere i contenuti visivi su larga scala.

L'API Markly è un'API REST che accetta dati multipart form. Invii un'immagine con i parametri della filigrana e ricevi l'immagine con watermark. L'autenticazione utilizza chiavi API passate nell'header Authorization.

L'API fornisce quattro endpoint principali:

Tutti gli endpoint accettano immagini JPEG, PNG e WebP fino a 25 MB. Le risposte restituiscono l'immagine elaborata direttamente nello stesso formato, oppure uno ZIP per le richieste batch.

Ecco esempi funzionanti per i linguaggi più comuni. Sostituisci YOUR_API_KEY con la tua chiave reale dalla dashboard sviluppatori.

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

with open("filigrana.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 Il Mio Brand");
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("filigrana.jpg", res.data);

L'API è disponibile su ogni piano Markly, incluso il piano gratuito. L'utilizzo si misura in crediti - un credito per immagine elaborata (testo o logo). Le richieste batch consumano un credito per ogni immagine nel blocco.

Tutti i piani a pagamento includono l'endpoint filigrana logo, l'elaborazione batch e le analisi di utilizzo. I crediti non utilizzati nei piani in abbonamento si accumulano per un mese. I limiti di frequenza sono per chiave API, non per IP.

Markly fornisce anche un server Model Context Protocol (MCP) che permette ad assistenti e agenti AI di applicare filigrane alle immagini per tuo conto. Se utilizzi strumenti come Claude, Cursor o agenti LLM personalizzati, il server MCP espone le stesse funzionalità di filigrana attraverso un'interfaccia tool standardizzata.

Il server MCP supporta filigrane testo, filigrane logo e elaborazione batch - le stesse funzionalità disponibili tramite l'API REST. Consulta la documentazione sviluppatori per le istruzioni di configurazione e il JSON di configurazione MCP.

Puoi iniziare a usare l'API filigrana in tre passaggi:

Riferimento completo degli endpoint, documentazione dei parametri e codici di errore sono disponibili nella documentazione sviluppatori.