Pro Model Documentation#

Quickstart#

1. Get an API key. Sign up (50 free credits, no credit card), then copy the key from your account.
2. Send an image.

   curl -X POST https://api.withoutbg.com/v1.0/image-without-background \
     -H "X-API-Key: $WITHOUTBG_API_KEY" \
     -F "file=@photo.jpg" \
     -o cutout.png

3. Use the result. cutout.png is a transparent RGBA PNG. Each HTTP 200 costs 1 credit.

Binary or Base64? Binary endpoints take multipart/form-data and return image bytes: use them from servers, CLIs and file pipelines. Base64 endpoints take and return JSON: use them from browsers, serverless functions and JSON-only pipelines.

Endpoints#

• Background Removal (Binary)Upload a file, get a transparent PNG back. Start here.
• Background Removal (Base64)Same cutout, as JSON in and out. For browsers and serverless.
• Alpha Matte (Binary)Grayscale mask only, so you composite the full-res original yourself.
• Alpha Matte (Base64)The alpha matte as Base64 JSON.
• Car Background Removal (Binary)Car photos: cutout with the cast shadow baked in.
• Car Background (Binary)Car placed on a studio backdrop, returned as JPEG.
• Car Layers (Base64)Car composite, cutout, shadow and backdrop layers in one JSON call.
• CreditsCheck the remaining balance and expiry for a key. Free to call.

Errors and limits#

Every endpoint returns these status codes on failure. Failed calls cost no credits.