Collage / Grid

कई छवियों को 25+ टेम्पलेट के साथ सुंदर ग्रिड कोलाज में संयोजित करें। अनुकूलन योग्य गैप, कोने की त्रिज्या, पृष्ठभूमि रंग, और प्रति-सेल पैन/ज़ूम नियंत्रण के साथ 2-9 छवि लेआउट का समर्थन करता है।

API Endpoint

POST /api/v1/tools/image/collage

Parameters

Parameter	Type	Required	Default	Description
templateId	string	Yes	-	टेम्पलेट लेआउट ID (उदा. 2-h-equal, 3-left-large, 4-grid, 9-grid)
cells	array	No	-	प्रति-सेल सेटिंग्स सरणी, जिसमें imageIndex, panX, panY, zoom, objectFit शामिल हैं
cells[].imageIndex	integer	Yes	-	इस सेल में रखी जाने वाली छवि का सूचकांक (0-आधारित)
cells[].panX	number	No	0	क्षैतिज पैन ऑफ़सेट (-100 से 100)
cells[].panY	number	No	0	ऊर्ध्वाधर पैन ऑफ़सेट (-100 से 100)
cells[].zoom	number	No	1	ज़ूम स्तर (1 से 10)
cells[].objectFit	string	No	"cover"	छवि सेल को कैसे भरती है: cover या contain
gap	number	No	8	सेलों के बीच का गैप पिक्सेल में (0 से 500)
cornerRadius	number	No	0	प्रत्येक सेल के लिए कोने की त्रिज्या पिक्सेल में (0 से 500)
backgroundColor	string	No	"#FFFFFF"	हेक्स के रूप में पृष्ठभूमि रंग या "transparent"
aspectRatio	string	No	"free"	कैनवास पहलू अनुपात: free, 1:1, 4:3, 3:2, 16:9, 9:16, 4:5
outputFormat	string	No	"png"	आउटपुट फ़ॉर्मेट: png, jpeg, webp, avif, jxl
quality	number	No	90	आउटपुट गुणवत्ता (1 से 100)

Available Templates

Template ID	Images	Layout
2-h-equal	2	दो बराबर कॉलम
2-v-equal	2	दो बराबर पंक्तियाँ
2-h-left-large	2	बायाँ 2/3, दायाँ 1/3
2-h-right-large	2	बायाँ 1/3, दायाँ 2/3
3-left-large	3	बड़ा बायाँ, दायीं ओर दो ढेर में
3-right-large	3	बायीं ओर दो ढेर में, बड़ा दायाँ
3-top-large	3	बड़ा ऊपर, नीचे दो कॉलम
3-h-equal	3	तीन बराबर कॉलम
3-v-equal	3	तीन बराबर पंक्तियाँ
4-grid	4	2x2 ग्रिड
4-left-large	4	बड़ा बायाँ, दायीं ओर तीन ढेर में
4-top-large	4	बड़ा ऊपर, नीचे तीन कॉलम
4-bottom-large	4	ऊपर तीन कॉलम, बड़ा नीचे
5-top2-bottom3	5	दो ऊपर, तीन नीचे
5-top3-bottom2	5	तीन ऊपर, दो नीचे
5-left-large	5	बड़ा बायाँ, दायीं ओर चार ढेर में
5-center-large	5	बड़ा केंद्र, चार कोने
6-grid-2x3	6	2 कॉलम x 3 पंक्तियाँ
6-grid-3x2	6	3 कॉलम x 2 पंक्तियाँ
6-top-large	6	बड़ा ऊपर, नीचे पाँच कॉलम
7-mosaic	7	मोज़ेक लेआउट
8-mosaic	8	मोज़ेक लेआउट
9-grid	9	3x3 ग्रिड

Example Request

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

Example Response

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

Notes

• मल्टीपार्ट अनुरोध में कई छवि फ़ाइलें अपलोड करें। छवियाँ अपलोड क्रम में टेम्पलेट सेलों को असाइन की जाती हैं।
• यदि टेम्पलेट के समर्थन से अधिक छवियाँ अपलोड की जाती हैं, तो अतिरिक्त छवियों को अनदेखा कर दिया जाता है।
• HEIC, RAW, PSD, और SVG इनपुट फ़ॉर्मेट का समर्थन करता है (स्वचालित रूप से डिकोड किए जाते हैं)।
• कैनवास का आधार आकार सबसे लंबी भुजा पर 2400px होता है, जो चुने गए पहलू अनुपात के अनुसार स्केल किया जाता है।
• जब aspectRatio "free" होता है, तो कैनवास डिफ़ॉल्ट रूप से 4:3 (2400x1800) होता है।
• प्रति-सेल panX/panY मान सेल के भीतर क्रॉप विंडो को स्थानांतरित करते हैं। 100 का मान पूरी तरह एक किनारे की ओर ले जाता है, -100 दूसरे की ओर।
• "transparent" पृष्ठभूमि रंग केवल png, webp, या avif आउटपुट फ़ॉर्मेट के साथ संरक्षित रहता है।