API

SigCleaner REST API 문서.

\/api\/clean 요청이 성공할 때마다 계정 잔액에서 1회의 처리 횟수가 차감됩니다.

메서드: 배경 제거

POST https://sigclean.io/api/clean
인증
Authorization: Bearer YOUR_API_KEY
요청 파라미터
파라미터타입필수설명
file multipart file 둘 중 하나 PNG, JPG 또는 PDF 이미지.
PDF가 여러 페이지인 경우 첫 페이지만 처리됩니다.
url string 둘 중 하나 이미지 직접 링크
type string 아니요 json (기본값) — 파일 링크가 포함된 JSON 반환
webp — 투명 배경의 WebP 바이너리 파일 반환
png — 투명 배경의 PNG 바이너리 파일 반환
extract string 아니요 특정 요소 추출. 기본값은 비어 있으며, 표준 배경 제거가 적용됩니다.
signature — 수기 서명만 남기고 나머지 모두 제거.
stamp — 도장 자국만 남기고 나머지 모두 제거.
aggressive boolean 아니요 강력한 텍스트 제거.
1 (true)로 설정 시, 인쇄된 문자, 숫자 및 양식의 검은색 직선을 강력하게 제거하여 지정된 요소만 남깁니다.
mode string 아니요 처리 모드. 기본값 — standard.
standard — 표준 모드. 고화질 이미지에 적합합니다. 결과물이 원본과 가장 유사하게 유지됩니다.
advanced — 스마트 모드. 더 정밀한 처리; 화질이 낮거나 불필요한 요소가 많은 이미지에 적합합니다.
name string 아니요 «내 파일» 목록에 표시되는 파일 이름입니다. 성공적으로 처리되면 저장됩니다.
응답: type=json
{ "status": "ok", "uuid": "550e8400-e29b-41d4-a716-446655440000", "url": "https://sigclean.io/api/file/550e8400-e29b-41d4-a716-446655440000", "remaining": 9, "limit": 10 }
응답: type=webp

투명한 배경의 WebP 바이너리 파일을 반환합니다. Content-Type: image/webp.

응답: type=png

투명한 배경의 PNG 바이너리 파일을 반환합니다. Content-Type: image/png.

cURL 예제
curl -X POST https://sigclean.io/api/clean \ -H "Authorization: Bearer YOUR_KEY" \ -F "file=@stamp.jpg" \ -F "type=json"
curl -X POST https://sigclean.io/api/clean \ -H "Authorization: Bearer YOUR_KEY" \ -F "file=@stamp.jpg" \ -F "type=png" \ --output result.png
curl -X POST https://sigclean.io/api/clean \ -H "Authorization: Bearer YOUR_KEY" \ -F "file=@stamp.jpg" \ -F "type=webp" \ --output result.webp

강력한 텍스트 제거 기능을 사용한 서명 추출:

curl -X POST https://sigclean.io/api/clean \ -H "Authorization: Bearer YOUR_KEY" \ -F "file=@document.jpg" \ -F "type=png" \ -F "extract=signature" \ -F "aggressive=1" \ --output signature.png

스마트 처리 모드:

curl -X POST https://sigclean.io/api/clean \ -H "Authorization: Bearer YOUR_KEY" \ -F "file=@stamp.jpg" \ -F "type=png" \ -F "mode=advanced" \ --output result.png
결과 다운로드
GET https://sigclean.io/api/file/{uuid}

메서드: 파일 목록

GET https://sigclean.io/api/files

현재 사용자의 성공적으로 처리된 모든 파일 목록을 반환합니다. 파일은 링크를 통해 이용할 수 있습니다. /api/file/{uuid}.

인증
Authorization: Bearer YOUR_API_KEY
응답
{ "status": "ok", "files": [ { "uuid": "550e8400-e29b-41d4-a716-446655440000", "name": "stamp.jpg", "url": "https://sigclean.io/api/file/550e8400-e29b-41d4-a716-446655440000", "created_at": "2026-07-01T10:00:00Z", "expires_at": "2027-07-01T10:00:00Z" } ] }
필드타입설명
uuid string 파일 고유 ID
name string | null 표시되는 파일 이름(\/api\/clean의 name 파라미터 또는 이름 변경 후)
url string 파일 다운로드 직접 링크(WebP)
created_at string (ISO 8601) 파일 생성 일시(UTC)
expires_at string | null 보관 만료일(UTC).
cURL 예제
curl https://sigclean.io/api/files \ -H "Authorization: Bearer YOUR_KEY"

메서드: 파일 삭제

POST https://sigclean.io/api/files/delete

서버에서 파일을 영구적으로 삭제합니다. 파일은 현재 사용자 소유여야 합니다.

인증
Authorization: Bearer YOUR_API_KEY
요청 본문 application\/json
파라미터타입필수설명
uuid string 예 \/api\/clean 또는 \/api\/files 응답의 파일 UUID.
응답
{ "status": "ok" }
오류 코드
코드설명
401인증되지 않음
404파일을 찾을 수 없거나 사용자 소유가 아님
422uuid가 누락되었거나 올바르지 않습니다.
cURL 예제
curl -X POST https://sigclean.io/api/files/delete \ -H "Authorization: Bearer YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"uuid":"550e8400-e29b-41d4-a716-446655440000"}'

메서드: 파일 이름 변경

POST https://sigclean.io/api/files/rename

표시되는 파일 이름을 변경합니다. 파일은 현재 사용자 소유여야 합니다.

인증
Authorization: Bearer YOUR_API_KEY
요청 본문 application\/json
파라미터타입필수설명
uuid string 예 \/api\/clean 또는 \/api\/files 응답의 파일 UUID.
name string 예 새로 표시할 파일 이름(최대 255자).
응답
{ "status": "ok", "name": "stamp.jpg" }
오류 코드
코드설명
401인증되지 않음
404파일을 찾을 수 없거나 사용자 소유가 아님
422uuid \/ name이(가) 누락되었거나 올바르지 않습니다.
cURL 예제
curl -X POST https://sigclean.io/api/files/rename \ -H "Authorization: Bearer YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"uuid":"550e8400-e29b-41d4-a716-446655440000","name":"stamp.jpg"}'

API 키 관리

키를 관리하려면 로그인해야 합니다.