Beautify Screenshot

스크린샷에 그라디언트 배경, 기기 프레임, 그림자, 워터마크, 소셜 미디어 크기 조정을 추가합니다. 제품 마케팅, 소셜 미디어, 문서용의 세련된 이미지를 만드는 데 이상적입니다.

API 엔드포인트

POST /api/v1/tools/image/beautify

매개변수

매개변수	유형	필수	기본값	설명
backgroundType	string	아니요	"linear-gradient"	배경 유형: solid, linear-gradient, radial-gradient, image, transparent
backgroundColor	string	아니요	"#667eea"	단색 배경 색상 (backgroundType이(가) solid일 때 사용)
gradientStops	array	아니요	[{"color":"#667eea","position":0},{"color":"#764ba2","position":100}]	그라디언트 색상 정지점 (최소 2개). 각 정지점은 color(16진수)과 position(0-100)을 가집니다.
gradientAngle	number	아니요	135	그라디언트 각도 (0 ~ 360)
padding	number	아니요	64	이미지 주위의 여백 픽셀 (0 ~ 256)
borderRadius	number	아니요	12	스크린샷의 모서리 반경 (0 ~ 64)
shadowPreset	string	아니요	"subtle"	그림자 프리셋: none, subtle, medium, dramatic, custom
shadowBlur	number	아니요	20	사용자 지정 그림자 블러 반경 (0 ~ 100, shadowPreset이(가) custom일 때 사용)
shadowOffsetX	number	아니요	0	사용자 지정 그림자 수평 오프셋 (-50 ~ 50)
shadowOffsetY	number	아니요	10	사용자 지정 그림자 수직 오프셋 (-50 ~ 50)
shadowColor	string	아니요	"#000000"	16진수 형식의 사용자 지정 그림자 색상
shadowOpacity	number	아니요	30	사용자 지정 그림자 불투명도 (0 ~ 100)
frame	string	아니요	"none"	기기 또는 창 프레임: none, macos-light, macos-dark, windows-light, windows-dark, browser-light, browser-dark, iphone, iphone-dark, macbook, macbook-dark, ipad, ipad-dark
frameTitle	string	아니요	-	창 프레임 제목 표시줄에 표시되는 제목 텍스트
socialPreset	string	아니요	"none"	소셜 미디어 크기로 조정: none, twitter, linkedin, instagram-square, instagram-story, facebook, producthunt
watermarkText	string	아니요	-	선택적 워터마크 텍스트 오버레이
watermarkPosition	string	아니요	"bottom-right"	워터마크 위치: top-left, top-right, bottom-left, bottom-right, center
watermarkOpacity	number	아니요	50	워터마크 불투명도 (0 ~ 100)
outputFormat	string	아니요	"png"	출력 형식: png, jpeg, webp

요청 예시

curl -X POST http://localhost:1349/api/v1/tools/image/beautify \
  -F "file=@screenshot.png" \
  -F 'settings={"backgroundType":"linear-gradient","gradientStops":[{"color":"#667eea","position":0},{"color":"#764ba2","position":100}],"gradientAngle":135,"padding":64,"borderRadius":12,"shadowPreset":"medium","frame":"macos-dark","socialPreset":"twitter"}'

배경 이미지 사용

curl -X POST http://localhost:1349/api/v1/tools/image/beautify \
  -F "file=@screenshot.png" \
  -F "backgroundImage=@bg-texture.jpg" \
  -F 'settings={"backgroundType":"image","padding":80,"borderRadius":16,"shadowPreset":"dramatic"}'

응답 예시

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/screenshot.png",
  "originalSize": 234567,
  "processedSize": 567890
}

참고 사항

• 두 개의 파일 필드를 받습니다: file(필수, 메인 스크린샷)과 backgroundImage(선택, backgroundType이(가) image일 때 사용).
• HEIC, RAW, PSD, SVG 입력 형식을 지원합니다(자동 디코딩).
• 그림자 프리셋은 특정 값에 매핑됩니다:
  • subtle: 블러 20, offsetY 4, 불투명도 20%
  • medium: 블러 40, offsetY 10, 불투명도 35%
  • dramatic: 블러 80, offsetY 20, 불투명도 50%
• 소셜 미디어 프리셋은 contain 모드를 사용하여 최종 출력을 대상 크기에 맞게 조정합니다:
  • twitter: 1600x900
  • linkedin: 1200x627
  • instagram-square: 1080x1080
  • instagram-story: 1080x1920
  • facebook: 1200x630
  • producthunt: 1270x760
• 기기 프레임(iphone, macbook, ipad)은 이미지 주위에 하드웨어 베젤을 적용하고 borderRadius 설정을 건너뜁니다.
• 투명도가 필요한 경우(그림자, 모서리 반경, 기기 프레임, 투명 배경), jpeg을(를) 선택하더라도 출력은 PNG로 강제됩니다.
• 이미지 배경은 파이프라인/배치 모드에서 지원되지 않습니다.