Collage / Rutnät

Kombinera flera bilder till snygga rutnätscollage med 25+ mallar. Stöder layouter för 2-9 bilder med anpassningsbart mellanrum, hörnradie, bakgrundsfärg och kontroller för panorering/zoom per cell.

API-slutpunkt

POST /api/v1/tools/image/collage

Parametrar

Parameter	Typ	Obligatorisk	Standard	Beskrivning
templateId	string	Ja	-	Mallens layout-ID (t.ex. 2-h-equal, 3-left-large, 4-grid, 9-grid)
cells	array	Nej	-	Array med inställningar per cell med imageIndex, panX, panY, zoom, objectFit
cells[].imageIndex	integer	Ja	-	Index för bilden som ska placeras i denna cell (0-baserat)
cells[].panX	number	Nej	0	Horisontell panoreringsförskjutning (-100 till 100)
cells[].panY	number	Nej	0	Vertikal panoreringsförskjutning (-100 till 100)
cells[].zoom	number	Nej	1	Zoomnivå (1 till 10)
cells[].objectFit	string	Nej	"cover"	Hur bilden fyller cellen: cover eller contain
gap	number	Nej	8	Mellanrum mellan celler i pixlar (0 till 500)
cornerRadius	number	Nej	0	Hörnradie för varje cell i pixlar (0 till 500)
backgroundColor	string	Nej	"#FFFFFF"	Bakgrundsfärg som hex eller "transparent"
aspectRatio	string	Nej	"free"	Ritytans bildförhållande: free, 1:1, 4:3, 3:2, 16:9, 9:16, 4:5
outputFormat	string	Nej	"png"	Utdataformat: png, jpeg, webp, avif, jxl
quality	number	Nej	90	Utdatakvalitet (1 till 100)

Tillgängliga mallar

Mall-ID	Bilder	Layout
2-h-equal	2	Två lika kolumner
2-v-equal	2	Två lika rader
2-h-left-large	2	Vänster 2/3, höger 1/3
2-h-right-large	2	Vänster 1/3, höger 2/3
3-left-large	3	Stor till vänster, två staplade till höger
3-right-large	3	Två staplade till vänster, stor till höger
3-top-large	3	Stor upptill, två kolumner nedtill
3-h-equal	3	Tre lika kolumner
3-v-equal	3	Tre lika rader
4-grid	4	2x2-rutnät
4-left-large	4	Stor till vänster, tre staplade till höger
4-top-large	4	Stor upptill, tre kolumner nedtill
4-bottom-large	4	Tre kolumner upptill, stor nedtill
5-top2-bottom3	5	Två upptill, tre nedtill
5-top3-bottom2	5	Tre upptill, två nedtill
5-left-large	5	Stor till vänster, fyra staplade till höger
5-center-large	5	Stor i mitten, fyra i hörnen
6-grid-2x3	6	2 kolumner x 3 rader
6-grid-3x2	6	3 kolumner x 2 rader
6-top-large	6	Stor upptill, fem kolumner nedtill
7-mosaic	7	Mosaiklayout
8-mosaic	8	Mosaiklayout
9-grid	9	3x3-rutnät

Exempelbegäran

curl -X POST http://localhost:1349/api/v1/tools/image/collage \
  -F "[email protected]" \
  -F "[email protected]" \
  -F "[email protected]" \
  -F "[email protected]" \
  -F 'settings={"templateId":"4-grid","gap":12,"cornerRadius":8,"backgroundColor":"#F5F5F5","outputFormat":"png","quality":90}'

Exempelsvar

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/collage.png",
  "originalSize": 2456789,
  "processedSize": 1823456
}

Anteckningar

• Ladda upp flera bildfiler i multipart-begäran. Bilderna tilldelas mallcellerna i uppladdningsordning.
• Om fler bilder laddas upp än vad mallen stöder ignoreras de extra bilderna.
• Stöder indataformaten HEIC, RAW, PSD och SVG (avkodas automatiskt).
• Ritytans basstorlek är 2400px på den längsta sidan, skalad efter valt bildförhållande.
• När aspectRatio är "free" blir ritytan som standard 4:3 (2400x1800).
• Värden för panX/panY per cell förskjuter beskärningsfönstret inom cellen. Värdet 100 flyttar helt till en kant, -100 till den andra.
• Bakgrundsfärgen "transparent" bevaras endast med utdataformaten png, webp eller avif.