Cutplay
Cutplay API

배경 제거 API 문서

할인 적용 중

API 키로 이미지를 업로드하면 누끼 처리된 파일을 바로 응답받을 수 있습니다. 현재 할인 적용 중이며, API 호출 1회당 5P (정상가 20P)가 차감됩니다.

요금

할인 적용 중
API 배경 제거 (1회)

API 키로 요청 1회가 성공할 때 차감됩니다.

75% 할인
정상가20P
할인가5P

응답

성공 시 선택한 포맷의 이미지 바이너리를 반환합니다.

X-Cutplay-Model, X-Cutplay-Points-Charged 헤더가 포함됩니다.

오류 코드

400파일 또는 옵션이 잘못된 경우
401API 키가 없거나 유효하지 않은 경우
402포인트가 부족한 경우
429포인트가 부족한 상태에서 짧은 시간에 요청이 반복된 경우
503서버에 모델이 로드되지 않은 경우

엔드포인트

multipart/form-data로 파일과 옵션을 전송합니다.

POST /api/v1/remove-background/

cURL 예제

curl -X POST https://cutplay.kr/api/v1/remove-background/ \
  -H "Authorization: Bearer cp_live_your_api_key" \
  -F "file=@sample.jpg" \
  -F "model=normal" \
  -F "fmt=PNG" \
  -F "useOriginalResolution=true" \
  --output cutplay_sample.png

JavaScript 예제

const form = new FormData()
form.set("file", file)
form.set("model", "hr")
form.set("fmt", "WEBP")
form.set("quality", "90")
form.set("useOriginalResolution", "false")
form.set("canvasW", "1200")
form.set("canvasH", "1200")

const res = await fetch("https://cutplay.kr/api/v1/remove-background/", {
  method: "POST",
  headers: { Authorization: `Bearer ${apiKey}` },
  body: form,
})

if (!res.ok) throw new Error(await res.text())
const result = await res.blob()

인증

  • `Authorization: Bearer <API_KEY>` 헤더를 권장합니다.
  • `X-API-Key: <API_KEY>` 헤더도 지원합니다.

편집 설정

  • `model`: `normal` 또는 `hr` 중 선택합니다. 파일 하나를 응답하므로 `both`는 지원하지 않습니다.
  • 지우개 편집은 브라우저 수동 작업이므로 API 옵션에서 제외됩니다.

저장 설정

  • `fmt`: `PNG`, `WEBP`, `JPEG`를 지원합니다.
  • `quality`: `WEBP`/`JPEG` 품질입니다. 1부터 100까지 입력합니다.
  • `prefix`: 응답 파일명 접두사입니다. 기본값은 `cutplay_`입니다.
  • `useOriginalResolution`: `true`면 결과 해상도를 그대로 사용합니다.
  • `canvasW`, `canvasH`: `useOriginalResolution=false`일 때 중앙 정렬 캔버스 크기입니다.
  • `canvas_enabled`, `canvas_wh`: 기존 저장 API와 같은 별칭도 지원합니다.

API 키

키는 생성 직후 한 번만 전체 값이 표시됩니다. 서버에는 해시만 저장됩니다.