Collage / Raster

Kombiniert mehrere Bilder zu ansprechenden Rastercollagen mit über 25 Vorlagen. Unterstützt Layouts für 2 bis 9 Bilder mit anpassbarem Abstand, Eckenradius, Hintergrundfarbe sowie Schwenk-/Zoom-Steuerung pro Zelle.

API-Endpunkt

POST /api/v1/tools/image/collage

Parameter

Parameter	Typ	Erforderlich	Standard	Beschreibung
templateId	string	Ja	-	ID des Vorlagenlayouts (z. B. 2-h-equal, 3-left-large, 4-grid, 9-grid)
cells	array	Nein	-	Array mit Einstellungen pro Zelle mit imageIndex, panX, panY, zoom, objectFit
cells[].imageIndex	integer	Ja	-	Index des Bildes, das in diese Zelle platziert wird (0-basiert)
cells[].panX	number	Nein	0	Horizontaler Schwenkversatz (-100 bis 100)
cells[].panY	number	Nein	0	Vertikaler Schwenkversatz (-100 bis 100)
cells[].zoom	number	Nein	1	Zoomstufe (1 bis 10)
cells[].objectFit	string	Nein	"cover"	Wie das Bild die Zelle ausfüllt: cover oder contain
gap	number	Nein	8	Abstand zwischen den Zellen in Pixeln (0 bis 500)
cornerRadius	number	Nein	0	Eckenradius jeder Zelle in Pixeln (0 bis 500)
backgroundColor	string	Nein	"#FFFFFF"	Hintergrundfarbe als Hex-Wert oder "transparent"
aspectRatio	string	Nein	"free"	Seitenverhältnis der Leinwand: free, 1:1, 4:3, 3:2, 16:9, 9:16, 4:5
outputFormat	string	Nein	"png"	Ausgabeformat: png, jpeg, webp, avif, jxl
quality	number	Nein	90	Ausgabequalität (1 bis 100)

Verfügbare Vorlagen

Vorlagen-ID	Bilder	Layout
2-h-equal	2	Zwei gleich große Spalten
2-v-equal	2	Zwei gleich große Zeilen
2-h-left-large	2	Links 2/3, rechts 1/3
2-h-right-large	2	Links 1/3, rechts 2/3
3-left-large	3	Groß links, zwei gestapelt rechts
3-right-large	3	Zwei gestapelt links, groß rechts
3-top-large	3	Groß oben, zwei Spalten unten
3-h-equal	3	Drei gleich große Spalten
3-v-equal	3	Drei gleich große Zeilen
4-grid	4	2x2-Raster
4-left-large	4	Groß links, drei gestapelt rechts
4-top-large	4	Groß oben, drei Spalten unten
4-bottom-large	4	Drei Spalten oben, groß unten
5-top2-bottom3	5	Zwei oben, drei unten
5-top3-bottom2	5	Drei oben, zwei unten
5-left-large	5	Groß links, vier gestapelt rechts
5-center-large	5	Groß in der Mitte, vier Ecken
6-grid-2x3	6	2 Spalten x 3 Zeilen
6-grid-3x2	6	3 Spalten x 2 Zeilen
6-top-large	6	Groß oben, fünf Spalten unten
7-mosaic	7	Mosaiklayout
8-mosaic	8	Mosaiklayout
9-grid	9	3x3-Raster

Beispielanfrage

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}'

Beispielantwort

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

Hinweise

• Laden Sie mehrere Bilddateien in der Multipart-Anfrage hoch. Die Bilder werden den Vorlagenzellen in der Reihenfolge des Hochladens zugewiesen.
• Werden mehr Bilder hochgeladen, als die Vorlage unterstützt, werden die überzähligen Bilder ignoriert.
• Unterstützt HEIC-, RAW-, PSD- und SVG-Eingabeformate (werden automatisch dekodiert).
• Die Basisgröße der Leinwand beträgt 2400 px an der längsten Seite und wird anhand des gewählten Seitenverhältnisses skaliert.
• Wenn aspectRatio "free" ist, verwendet die Leinwand standardmäßig 4:3 (2400x1800).
• Die Werte panX/panY pro Zelle verschieben das Zuschneidefenster innerhalb der Zelle. Ein Wert von 100 verschiebt vollständig zu einer Kante, -100 zur anderen.
• Die Hintergrundfarbe "transparent" bleibt nur bei den Ausgabeformaten png, webp oder avif erhalten.