이미지

이미지 크기 변경

가로·세로 맞추기

엔드포인트

POST/api/v1/tools/image-resize

화면에서 사용해 보기

입력

filesfile[]필수

1~50개

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

옵션

widthnumber (0–20000)기본값 1920

너비 — 0이면 비율대로

heightnumber (0–20000)기본값 0

높이

fitstring (enum)기본값 inside

맞추는 방법inside · cover · fill

결과

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

요청

curl -X POST https://utils.pah.kr/api/v1/tools/image-resize \
  -F "files=@a.jpg" \
  -F "width=1920" \
  -F "height=0" \
  -F "fit=inside"

응답

{
  "ok": true,
  "tool": "image-resize",
  "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_resize",
  "arguments": {
    "files": [
      "/path/to/a.jpg"
    ],
    "width": 1920,
    "height": 0,
    "fit": "inside"
  }
}