이미지

이미지 이어붙이기

여러 장을 한 장으로

엔드포인트

POST/api/v1/tools/image-join

화면에서 사용해 보기

입력

filesfile[]필수

2~30개 · 이미지 (올린 순서대로 이어집니다)

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

옵션

directionstring (enum)기본값 vertical

방향vertical · horizontal

gapnumber (0–200)기본값 0

간격

backgroundstring (#RRGGBB)기본값 #FFFFFF

빈 곳 색

결과

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

요청

curl -X POST https://utils.pah.kr/api/v1/tools/image-join \
  -F "files=@a.jpg" \
  -F "files=@b.jpg" \
  -F "direction=vertical" \
  -F "gap=0" \
  -F "background=#FFFFFF"

응답

{
  "ok": true,
  "tool": "image-join",
  "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_join",
  "arguments": {
    "files": [
      "/path/to/a.jpg",
      "/path/to/b.jpg"
    ],
    "direction": "vertical",
    "gap": 0,
    "background": "#FFFFFF"
  }
}