Collage de imágenes

Collage de imágenes es una API que combina varias fotos en una sola, en cuadrícula (tipo hoja de contacto). Cada imagen se ajusta dentro de su celda sin recortarla ni deformarla.

Cómo funciona

Le mandas un array de imágenes (mínimo 2, máximo 30) y te devuelve una sola imagen con todas colocadas en cuadrícula. El número de columnas se calcula solo (una cuadrícula lo más cuadrada posible) si no lo dices.

Lo único que necesitas

Tu API key. La creas en tu panel con "+ Crear llave".
En tu plataforma de automatización, un paso de tipo "HTTP Request" (n8n, Make, Zapier, Pipedream…).

Cómo usarlo en n8n

Method: POST · URL: https://api.cofferdock.com/image-collage
Send Headers: x-api-key = tu llave, Content-Type = application/json
Send Body (JSON): { "images": ["<base64 1>", "<base64 2>", "<base64 3>"] }
En Options → Response → Response Format: elige File

Opciones

Opción	Por defecto	Para qué sirve
`images`	-	Obligatorio. Array de 2 a 30 imágenes en base64.
`columns`	automático	Cuántas columnas.
`cell_width`, `cell_height`	`400`	Tamaño de cada celda en píxeles.
`gap`	`10`	Separación en píxeles entre imágenes y en el borde.
`background`	`#ffffff`	Color de fondo en las celdas y el hueco.

Resumen de la API

Endpoint: POST https://api.cofferdock.com/image-collage
Auth: x-api-key: TU_LLAVE.
Entrada: SOLO JSON (varios binarios no caben a la vez en un cuerpo crudo).
Motor: sharp. Cada imagen se ajusta con fit: inside (nunca recorta) y se centra en su celda.
Límites: 30 peticiones/min por IP. Lienzo final hasta 60 megapíxeles. 1 llamada = 1 crédito, sin importar cuántas imágenes lleve.

Ejemplo

curl -X POST "https://api.cofferdock.com/image-collage" \
  -H "x-api-key: TU_LLAVE" -H "Content-Type: application/json" \
  -d '{"images":["...","...","..."],"columns":3}' \
  --output collage.png

Respuesta

{ "success": true, "image": "iVBORw0KGgo...", "mime_type": "image/png",
    "meta": { "count": 3, "columns": 3, "rows": 1, "width": 1230, "height": 420,
    "size_bytes": 84213, "used": 12, "remaining": 488 } }

Lo que recibes

Por defecto (JSON): image en base64. Añade output=image para el binario directo, o output=url para un enlace temporal.