API de marca de água
para programadores

A aplicação manual de marcas de água funciona para um punhado de imagens, mas não é escalável. Se está a desenvolver uma plataforma que gere uploads de utilizadores, a gerir uma loja online com fotografias de produtos, ou a manter um portfólio de fotografia com centenas de imagens, precisa de automação. Uma API de marca de água permite adicionar marcas como parte do seu pipeline existente - sem passos manuais, sem software de desktop, sem estrangulamento humano.

Com a API Markly, a marca de água resume-se a uma única chamada HTTP. Envie uma imagem, especifique as definições da marca e receba o resultado em segundos. Integra-se em pipelines CI/CD, hooks de CMS, backends de aplicações móveis e scripts de processamento em lote. Combinada com uma sólida estratégia de proteção de fotografias, a marca de água via API é a forma mais fiável de proteger conteúdo visual em escala.

A API Markly é uma REST API que aceita dados multipart form. Envia uma imagem juntamente com os parâmetros da marca de água e recebe de volta a imagem marcada. A autenticação utiliza chaves API passadas no cabeçalho Authorization.

A API disponibiliza quatro endpoints principais:

Todos os endpoints aceitam imagens JPEG, PNG e WebP até 25 MB. As respostas devolvem a imagem processada diretamente no mesmo formato, ou um ZIP para pedidos em lote.

Aqui estão exemplos funcionais para as linguagens mais comuns. Substitua YOUR_API_KEY pela sua chave real, disponível no painel de programador.

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

with open("marca-dagua.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 A Minha Marca");
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("marca-dagua.jpg", res.data);

A API está disponível em todos os planos Markly, incluindo o plano gratuito. A utilização é medida em créditos - um crédito por imagem processada (texto ou logótipo). Os pedidos em lote consomem um crédito por imagem no lote.

Todos os planos pagos incluem o endpoint de marca de água com logótipo, processamento em lote e análise de utilização. Os créditos não utilizados nos planos de subscrição transitam durante um mês. Os limites de pedidos são por chave API, não por IP.

O Markly também disponibiliza um servidor Model Context Protocol (MCP) que permite a assistentes e agentes de IA aplicar marcas de água nas suas imagens. Se utiliza ferramentas como Claude, Cursor ou agentes LLM personalizados, o servidor MCP expõe as mesmas capacidades de marca de água através de uma interface de ferramentas padronizada.

O servidor MCP suporta marcas de água de texto, marcas com logótipo e processamento em lote - as mesmas funcionalidades disponíveis através da REST API. Consulte a documentação para programadores para instruções de configuração e o JSON de configuração MCP.

Pode começar a utilizar a API de marca de água em três passos:

A referência completa dos endpoints, documentação de parâmetros e códigos de erro estão disponíveis na documentação para programadores.