Developer guide / Quick start

Quick start

From an image to a clean cutout. The editor and API use the same engine and credit balance.

Base URL: https://clearcut.sh

1. Create your API key

Create an account, verify your email, then create a key under API keys. Verified accounts receive 30 free credits every month, shared by the website and API: 30 Fast images or 15 Fine images. Buy more credits when needed.

2. Make your first request

Send a file, image URL or Base64 data. Set size=full for original dimensions. Fast costs 1 credit; Fine detail costs 2.

curl https://clearcut.sh/v1.0/removebg \
  -H "X-API-Key: $CLEARCUT_API_KEY" \
  -H 'Idempotency-Key: catalog-photo-001' \
  -F 'image_file=@photo.jpg' \
  -F 'size=full' -F 'format=png' \
  -o cutout.png

3. Use jobs for reliable integrations

For batches or requests that may take longer, submit to POST /api/jobs, poll the returned job ID, then download the result. Read the jobs reference →

4. Keep useful defaults

Use one idempotency key per logical image request. Respect Retry-After. Download files within one hour. Store API keys only on your server.

Clearcut support