API de marcas de agua
para desarrolladores

Añadir marcas de agua a mano funciona para unas pocas imágenes, pero no escala. Si estás creando una plataforma con subidas de usuarios, gestionando una tienda online con fotos de productos o un portafolio de fotografía con cientos de imágenes, necesitas automatización. Una API de marcas de agua te permite añadirlas como parte de tu flujo existente, sin pasos manuales, sin software de escritorio, sin cuellos de botella humanos.

Con la API de Markly, añadir una marca de agua se reduce a una única llamada HTTP. Sube una imagen, especifica la configuración y recibe el resultado en segundos. Se integra en pipelines CI/CD, hooks de CMS, backends de apps móviles y scripts por lotes por igual. Combinado con una buena estrategia de protección de fotos, la automatización por API es la forma más fiable de proteger contenido visual a gran escala.

La API de Markly es una API REST que acepta datos multipart. Envías una imagen junto con los parámetros de la marca de agua y recibes la imagen procesada. La autenticación utiliza claves API enviadas en la cabecera Authorization.

La API ofrece cuatro endpoints principales:

Todos los endpoints aceptan imágenes JPEG, PNG y WebP de hasta 25 MB. Las respuestas devuelven la imagen procesada directamente en el mismo formato, o un ZIP para las peticiones por lotes.

Aquí tienes ejemplos funcionales para los lenguajes más comunes. Sustituye YOUR_API_KEY por tu clave real desde el panel de desarrolladores.

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

with open("marca-de-agua.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 Mi 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-de-agua.jpg", res.data);

La API está disponible en todos los planes de Markly, incluido el gratuito. El uso se mide en créditos - un crédito por imagen procesada (texto o logo). Las peticiones por lotes consumen un crédito por cada imagen del lote.

Todos los planes de pago incluyen el endpoint de marca de agua con logo, procesamiento por lotes y analíticas de uso. Los créditos no utilizados en los planes de suscripción se acumulan durante un mes. Los límites de peticiones son por clave API, no por IP.

Markly también ofrece un servidor Model Context Protocol (MCP) que permite a asistentes y agentes de IA añadir marcas de agua a tus imágenes. Si usas herramientas como Claude, Cursor u otros agentes LLM, el servidor MCP expone las mismas funcionalidades de marca de agua a través de una interfaz de herramientas estandarizada.

El servidor MCP admite marcas de agua de texto, de logo y procesamiento por lotes - las mismas funciones disponibles en la API REST. Consulta la documentación para desarrolladores para instrucciones de configuración y el JSON de configuración MCP.

Puedes empezar a usar la API de marcas de agua en tres pasos:

La referencia completa de endpoints, documentación de parámetros y códigos de error están disponibles en la documentación para desarrolladores.