신규 사용자는 무료 크레딧 제공, 신용카드 불필요 시작하기
APIAny logoAPIAny

이미지 자르기

픽셀 좌표로 정확한 사각형 영역을 자릅니다.

POST /api/free/crop-image

이미지 자르기 온라인 사용

API 키 없이 업로드, 설정, 미리보기와 다운로드를 이용할 수 있습니다.

로그인 및 API 키 불필요

1. 업로드 및 설정

API 키 없이 사용할 수 있습니다. 파일은 실행할 때만 전송됩니다.

이미지 파일 *
왼쪽 오프셋 *
위쪽 오프셋 *
자르기 너비 *
자르기 높이 *
출력 형식
필수 항목을 입력하면 실행할 수 있습니다.POST /api/free-online/crop-image

2. 미리보기 및 다운로드

결과가 여기에 표시됩니다

미리보기, 크기 변화와 다운로드 버튼이 여기에 표시됩니다

유료 일괄 옵션

같은 작업을 여러 파일에 적용할 때 해당 유료 일괄 페이지를 여세요.

이미지 일괄 자르기

API로 연동

프로그램 호출에만 API 키가 필요합니다. 매개변수, 응답, 오류는 아래에서 확인할 수 있습니다.

API 엔드포인트
POST /api/free/crop-image

온라인 사용은 키가 필요 없습니다. 프로그램 호출에는 APIAny 키가 필요합니다.

작동 방식
  • 좌표는 왼쪽 위에서 시작합니다.
  • 자르기 영역은 원본 안에 있어야 합니다.

응답

성공 시 이 페이지에 설명된 Content-Type의 image 응답을 반환합니다.

일반 오류

400
파일이나 매개변수가 없거나 잘못되었거나 제한을 벗어났습니다.
401
프로그램 호출용 키가 없거나 잘못되었거나 비활성화되었습니다.
429
온라인 또는 인증 호출의 공유 제한에 도달했습니다.

매개변수와 제한

매개변수요구 사항기본값허용 값
image이미지 파일필수—file
left왼쪽 오프셋필수0number
top위쪽 오프셋필수0number
width자르기 너비필수500number
height자르기 높이필수500number
format출력 형식선택webpwebp, png, jpeg

API 예제

아래는 코드용 인증 예제입니다. 위 Playground는 API 키를 요구하거나 노출하지 않습니다.

curl -X POST "https://apiany.ai/api/free/crop-image" \
  -H "Authorization: Bearer $API_KEY" \
  -F "image=@input.jpg" \
  -F "left=0" \
  -F "top=0" \
  -F "width=500" \
  -F "height=500" \
  --output cropped.webp

자주 묻는 질문

이미지 자르기에 API 키가 필요한가요?

온라인 Playground에서는 필요 없습니다. 프로그램 호출은 Authorization: Bearer 또는 X-API-Key를 사용합니다.

이미지 자르기의 제한은 무엇인가요?

온라인은 분당 3회, 하루 30회입니다. 인증된 무료 계정은 5 RPM, 유료 계정은 모든 무료 API 합계 500 RPM입니다.

이미지 자르기는 어떤 입력을 지원하나요?

매개변수 표의 필수 및 선택 항목을 사용하세요. 지원하지 않는 형식과 범위를 벗어난 값은 거부됩니다.

이미지 자르기는 무엇을 반환하나요?

성공 시 image 응답을, 실패 시 위 HTTP 상태 코드를 반환합니다.

출처: APIAny 무료 API 카탈로그와 실제 라우트 동작. 검토일: 2026-07-17.