이미지 변환 API 문서 - WebP 변환용 REST API

개요

Convert2WebP API를 사용하면 프로그래밍 방식으로 형식 간에 이미지를 변환할 수 있습니다. 이미지와 함께 멀티파트 요청을 보내고 응답 본문으로 변환된 파일을 받습니다. 모든 처리는 대부분의 파일에 대해 1초 미만의 대기 시간으로 서버 측에서 이루어집니다.

기본 URL

https://convert2webp.com/api/v1

인증

인증이 필요하지 않습니다. API는 무료이며 개방적입니다. 모든 요청의 속도는 IP 주소당 분당 60개 요청으로 제한됩니다.

속도 제한

IP 주소별로 속도 제한이 적용됩니다. 모든 응답에는 속도 제한 헤더가 포함됩니다.

한계	최대 파일 크기	최대 배치 파일
요청 60개/분	파일당 10MB	배치당 파일 20개

모든 응답에는 속도 제한 헤더가 포함됩니다. X-RateLimit-Remaining, X-RateLimit-Reset.

엔드포인트

단일 이미지를 대상 형식으로 변환합니다. 이미지 파일과 선택적 매개변수가 포함된 multipart/form-data를 허용합니다.

매개변수

이름	유형	필수의	설명
file	File	필수의	변환할 이미지 파일입니다. PNG, JPG, GIF, BMP, TIFF, SVG, AVIF, ICO 및 WebP를 허용합니다.
output_format	string	선택 과목	대상 출력 형식: webp, png, jpg, gif, bmp 또는 pdf.(기본: `webp`)
quality	integer	선택 과목	출력 품질은 1(최저)부터 100(최고)까지입니다.(기본: `80`)
width	integer	선택 과목	최대 출력 너비(픽셀)입니다. 종횡비가 유지됩니다.
height	integer	선택 과목	최대 출력 높이(픽셀)입니다. 종횡비가 유지됩니다.
strip_metadata	boolean	선택 과목	출력에서 EXIF/IPTC/XMP 메타데이터를 제거합니다.(기본: `true`)

응답

200

변환된 이미지 바이너리image/webp

400

잘못된 요청(파일 누락, 지원되지 않는 형식 등)application/json

413

파일이 너무 큼application/json

429

비율 제한을 초과했습니다.application/json

500

내부 서버 오류application/json

코드 예제

terminal

curl -X POST https://convert2webp.com/api/v1/convert \
  -F "file=@photo.png" \
  -F "format=webp" \
  -F "quality=80" \
  -o converted.webp

테스트

파일

선택한 파일이 없습니다.

체재

품질 (80)

단일 요청으로 여러 이미지를 변환합니다. 변환된 모든 파일이 포함된 ZIP 아카이브를 반환합니다.

매개변수

이름	유형	필수의	설명
files	File[]	필수의	변환할 이미지 파일의 배열입니다. 요청당 최대 20개의 파일.
format	string	선택 과목	모든 파일에 적용되는 대상 출력 형식입니다.(기본: `webp`)
quality	integer	선택 과목	출력 품질은 1에서 100까지입니다.(기본: `80`)

응답

200

변환된 모든 이미지를 포함하는 ZIP 아카이브application/zip

400

잘못된 요청application/json

413

총 페이로드가 너무 큼application/json

429

비율 제한을 초과했습니다.application/json

코드 예제

terminal

curl -X POST https://convert2webp.com/api/v1/batch \
  -F "files=@image1.png" \
  -F "files=@image2.jpg" \
  -F "files=@image3.gif" \
  -F "format=webp" \
  -F "quality=80" \
  -o converted.zip

지원되는 모든 입력 및 출력 이미지 형식을 나열합니다.

응답

200

지원되는 입력 및 출력 형식을 나열하는 JSON 객체application/json

코드 예제

terminal

curl https://convert2webp.com/api/v1/formats

예시 응답

response.json

{
  "input": [
    "png", "jpg", "jpeg", "gif", "bmp",
    "tiff", "svg", "avif", "ico", "webp"
  ],
  "output": ["webp", "png", "jpg", "gif", "bmp", "pdf"]
}

서비스 가용성을 확인하세요.

응답

200

서비스 상태 및 버전application/json

코드 예제

terminal

curl https://convert2webp.com/api/v1/health

예시 응답

response.json

{
  "status": "ok",
  "version": "1.0.0",
  "timestamp": "2026-04-04T12:00:00.000Z"
}

오류 코드

모든 오류 응답은 JSON 본문을 반환합니다. error 무엇이 잘못되었는지 설명하는 객체입니다.

error-response.json

{
  "error": {
    "code": 429,
    "message": "Rate limit exceeded. Please wait 30 seconds before retrying."
  }
}

암호	이름	설명
400	잘못된 요청	요청 형식이 잘못되었습니다. 모든 필수 매개변수가 존재하고 유효한지 확인하십시오.
413	페이로드가 너무 큼	업로드된 파일이 10MB 제한을 초과했습니다.
415	지원되지 않는 미디어 유형	업로드된 파일 형식은 변환이 지원되지 않습니다.
429	요청이 너무 많습니다	속도 제한(분당 요청 60개)을 초과했습니다. 기다렸다가 다시 시도하세요.
500	내부 서버 오류	예상치 못한 오류가 발생했습니다. 이것이 지속되면 convert2webp@deployvision.com에 문의하세요.