Marca de agua en imagen

Marca de agua en imagen es una API que superpone un texto o tu logo sobre una foto o imagen. La hermana de Marca de agua en PDF, para cuando lo que hay que marcar es una imagen suelta, no un documento.

Cómo funciona

Le mandas una imagen y, o bien un texto, o bien tu logo (otra imagen), y te devuelve la primera con la marca superpuesta. Por defecto sale en diagonal, centrada y semitransparente.

Solo uno de los dos a la vez: texto O logo, no ambos en la misma llamada.

Lo único que necesitas

Tu API key. La creas en tu panel con "+ Crear llave". Se muestra una sola vez, así que cópiala y guárdala.
En tu plataforma de automatización, un paso de tipo "HTTP Request" / "Hacer una petición HTTP" (lo tienen n8n, Make, Zapier, Pipedream…).

Marca de texto: cómo usarlo en n8n

Le envías tu imagen tal cual (binario) y el texto como parámetro. En el nodo HTTP Request:

Method: POST
URL: https://api.cofferdock.com/image-watermark
Send Query Parameters: actívalo y añade text = © Mi Empresa (y lo que quieras: opacity, position… ver la tabla).
Send Headers: actívalo y añade x-api-key = tu llave.
Send Body: actívalo → elige mandar un archivo binario (en n8n: "n8n Binary File").
En Options → Response → Response Format: elige File

Marca de tu logo

Para usar un logo en vez de texto, hace falta mandar dos imágenes a la vez, así que solo funciona con el cuerpo en JSON:

{ "file": "<tu imagen en base64>", "image": "<tu logo en base64>" }

Opciones

Opción	Por defecto	Para qué sirve
`text`	-	El texto de la marca (máx. 200 caracteres). Usa esta O `image`.
`image`	-	Tu logo en base64. Solo con cuerpo JSON.
`position`	`center`	`center`, `top-left`, `top-right`, `bottom-left`, `bottom-right`.
`opacity`	`0.3`	0.05 (casi invisible) a 1 (sólida).
`rotation`	`45`	Grados de giro.

Resumen de la API

Endpoint: POST https://api.cofferdock.com/image-watermark
Auth: cabecera x-api-key: TU_LLAVE.
Entrada: texto → imagen a pelo (con text en Query) o JSON { file, text, ... }. Logo → SOLO JSON, { file, image, ... }.
Motor: sharp (libvips) + un overlay SVG del tamaño de la imagen. Sin navegador, sin binarios externos.
Límites: 30 peticiones/min por IP. 1 marca de agua = 1 crédito.

Opciones

Opción	Por defecto	Descripción
`text`	-	Máx. 200 caracteres. Exactamente uno de `text`/`image`.
`image`	-	Base64 de una imagen. Solo en modo JSON.
`position`	`center`	Centro o una esquina.
`opacity`	`0.3`	0.05–1.
`rotation`	`45`	Grados, cualquier valor.
`font_size`	~6% del ancho	8–400 px. Solo aplica a `text`.
`color`	`#808080`	Hex. Solo aplica a `text`.
`scale`	`0.3`	0.05–1: fracción del ancho que ocupa el logo. Solo aplica a `image`.
`format`	igual que la entrada	`jpeg`, `png`, `webp` o `avif`.

Ejemplos

curl:

curl -X POST "https://api.cofferdock.com/image-watermark?text=CONFIDENCIAL" \
  -H "x-api-key: TU_LLAVE" \
  -H "Content-Type: image/png" \
  --data-binary @foto.png \
  --output marcada.png

Respuesta

{ "success": true, "image": "iVBORw0KGgo...", "mime_type": "image/png",
    "meta": { "type": "text", "format": "png", "width": 1200, "height": 800,
    "size_bytes": 84213, "used": 12, "remaining": 488 } }

Lo que recibes

Por defecto: con la imagen a pelo devuelve la imagen; con JSON devuelve base64. Añade output=image para forzar el binario, o output=url para un enlace temporal (dura 15 minutos).