Car Background Removal (Base64)#

Base URL: https://api.withoutbg.com · Spec: openapi.json

Remove background from a car photo; return Base64 RGBA PNG in JSON.

Cost: 1 credit on HTTP 200.

Accepts reserved JSON fields include_shadow and translucent_windows (currently ignored). Binary sibling: /v1.0/car-image-without-background.

Endpoint#

POST /v1.0/car-image-without-background-base64

Base URL: https://api.withoutbg.com

Authentication#

Provide your API key in the request header:

API key header

X-API-Key: <your_api_key>

Request#

Content-Type: application/json

Fields#

  • image_base64 (string, required)Input image as a raw Base64 string (no `data:` URI prefix). Supported formats: JPEG, PNG, WebP, AVIF, HEIC, TIFF, BMP, GIF. Maximum decoded size: 20.0 MB.
  • include_shadow (boolean, optional)When true, keep/generate a soft shadow under the car. Reserved for an upcoming model feature; currently ignored.
  • translucent_windows (boolean, optional)When true, treat car windows as translucent rather than opaque. Reserved for an upcoming model feature; currently ignored.

Response#

Success Content-Type: application/json

Body fields#

  • input_dimensions (array<integer>, required)Decoded input size as `[width, height]` (pixels).
  • processed_dimensions (array<integer>, required)Size after server prep downscale (longest-side / megapixel caps) as `[width, height]`. Distinct from model inference resolution (~1024 long side).
  • was_downscaled (boolean, required)True when the input was downscaled during server prep.
  • image_type (object, optional)Optional probabilities for photo vs graphic image-type classes.
  • img_without_background_base64 (string, required)Result image as Base64 PNG (RGBA) with transparent background. Prepend `data:image/png;base64,` to display in a browser.

Errors#

StatusDescriptionDetail
401Invalid API KeyInvalid API Key
402Insufficient credit. Please top up API credits.Insufficient credit. Please top up API credits.
403Credits Expired. Please top up API credits. If you have existing credits, they will be reactivated.Credits Expired. Please top up API credits. If you have existing credits, they will be reactivated.
422Validation ErrorValidation Error
429Rate limit exceeded (product policy: 30 requests/minute per API key). May be returned by the API gateway. Retry with exponential backoff.{"error":"Too Many Requests","status":429,"message":"Rate limit exceeded. Please try again later"}
500Internal Server ErrorInternal Server Error. Please contact support: contact@withoutbg.com

Example (cURL)#

cURL

curl -X POST \
  -H "X-API-Key: $WITHOUTBG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image_base64":"<raw_base64>"}' \
  "https://api.withoutbg.com/v1.0/car-image-without-background-base64"

Contract sections are generated at build time from OpenAPI. Markdown mirror: /docs/pro-model/car-background-removal-base64.md