이미지

이미지 워터마크

사진 위에 글자 얹기

엔드포인트

POST/api/v1/tools/image-watermark

화면에서 사용해 보기

입력

filesfile[]필수

1~30개

형식jpg · jpeg · png · webp · avif · gif · tif · tiff · bmp · heic · heif

옵션

textstring필수기본값 사본

글자

sizenumber (10–400)기본값 48

크기

opacitynumber (5–100)기본값 40

진하기

colorstring (#RRGGBB)기본값 #FFFFFF

색

positionstring (enum)기본값 center

위치center · southeast · southwest · northeast · northwest · tile

결과

files 로 답합니다. 결과가 두 개 이상이면 zip 하나로 묶이고, 보관 시간이 지나면 내려받을 수 없습니다.

요청

curl -X POST https://utils.pah.kr/api/v1/tools/image-watermark \
  -F "files=@a.jpg" \
  -F "text=사본" \
  -F "size=48" \
  -F "opacity=40" \
  -F "color=#FFFFFF" \
  -F "position=center"

응답

{
  "ok": true,
  "tool": "image-watermark",
  "note": "처리 결과 요약",
  "files": [
    {
      "name": "result.jpg",
      "size": 128000,
      "url": "https://utils.pah.kr/api/v1/files/{token}/result.jpg"
    }
  ],
  "expiresAt": "2026-09-14T12:30:00.000Z"
}

MCP

{
  "name": "image_watermark",
  "arguments": {
    "files": [
      "/path/to/a.jpg"
    ],
    "text": "사본",
    "size": 48,
    "opacity": 40,
    "color": "#FFFFFF",
    "position": "center"
  }
}