{"service":"MOSOVN Image Generation Service","description":"API để tạo hình ảnh có text overlay, image overlay và QR code với khả năng upload lên AWS S3 (folder /u)","endpoints":{"POST /generate-image":{"description":"Tạo hình ảnh với text overlay và image overlay","body":{"templateUrl":"string - URL của hình template chính","outputWidth":"number - Chiều rộng output (mặc định 1080)","outputHeight":"number - Chiều cao output (mặc định 1080)","filename":"string - Tên file output (mặc định: generated-image.webp)","uploadToS3":"boolean - Upload hình ảnh lên AWS S3 vào folder /u và trả về URL (mặc định false)","images":[{"url":"string - URL của hình overlay","x":"number - Vị trí x (pixels từ trái)","y":"number - Vị trí y (pixels từ trên)","width":"number - Chiều rộng hình overlay","height":"number - Chiều cao hình overlay","borderRadius":"number - Bo góc (mặc định 0)","opacity":"number - Độ trong suốt (0-1, mặc định 1)"}],"qrCodes":[{"url":"string - URL mà QR code sẽ dẫn tới","iconUrl":"string - URL của icon hiển thị ở giữa QR (optional)","x":"number - Vị trí x (pixels từ trái)","y":"number - Vị trí y (pixels từ trên)","size":"number - Kích thước QR code (mặc định 200)","iconSize":"number - Kích thước icon ở giữa (mặc định 40)","backgroundColor":"string - Màu nền QR code (mặc định #ffffff)","foregroundColor":"string - Màu QR code (mặc định #000000)"}],"texts":[{"text":"string - Nội dung text","x":"number - Vị trí x (% từ trái, mặc định 50)","y":"number - Vị trí y (% từ trên, mặc định 50)","fontSize":"number - Kích thước font (mặc định 48)","fontFamily":"string - Font chữ (mặc định Arial)","fontWeight":"string - Độ đậm font (normal, bold, mặc định normal)","color":"string - Màu chữ (mặc định white)","strokeColor":"string - Màu viền (mặc định black)","strokeWidth":"number - Độ dày viền (mặc định 2)","textAnchor":"string - Căn chỉnh text (start, middle, end, mặc định middle)","backgroundColor":"string - Màu nền text (optional)","backgroundPadding":"number - Padding nền text (mặc định 10)","backgroundRadius":"number - Bo góc nền text (mặc định 0)","autoFit":"boolean - Tự động giảm fontSize khi text tràn (mặc định true)","minFontSize":"number - Kích thước font tối thiểu cho auto-fit (mặc định 12)","maxWidth":"number - Chiều rộng tối đa cho text (pixels) - khi text vượt quá chiều rộng này, fontSize sẽ tự động giảm (optional)","maxHeight":"number - Chiều cao tối đa cho text (optional)","margin":"number - Khoảng cách từ viền ảnh cho auto-fit (mặc định 20)","enableWrap":"boolean - Bật/tắt tính năng text wrapping (mặc định false)","textWidth":"number - Chiều rộng tối đa trước khi text xuống hàng (pixels)","lineHeight":"number - Hệ số khoảng cách giữa các dòng (mặc định 1.2)","verticalAlign":"string - Hướng tràn của text: \"top\" (chỉ xuống dưới), \"center\" (tràn 2 bên), \"bottom\" (chỉ lên trên) - mặc định \"center\""}]},"response":"image/webp (khi uploadToS3=false) hoặc application/json với s3Url (khi uploadToS3=true)"},"GET /sample-request":{"description":"Lấy mẫu request để tạo banner bất động sản"},"GET /health":{"description":"Kiểm tra tình trạng service"}}}