Car Layers (Base64)#

Endpoint#

POST /v1.0/car-layers-base64

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

Authentication#

Provide your API key in the request 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. Invalid Base64, non-image data, unsupported formats, or oversize payloads fail with HTTP 422.
• reconstruct_windows (boolean, optional) — When true (default), run car window reconstruction on the cutout: opens glass interiors while keeping the car outline. Shadow is predicted from the BiRefNet silhouette regardless. Set false to skip window reconstruction.
• include_touch_points (boolean, optional) — When true (default), detect up to 4 unordered ground-contact points on the car (processed-image pixels: x, y, heatmap score). Set false to skip and omit `touch` from the response.

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.
• view (object, optional) — Estimated camera orbit around the car. Omitted if the orientation head is not loaded. Azimuth 0° = front of the car, increasing counterclockwise from above. Elevation 0° = level look-at (mid-body height); positive = camera above the car.
• touch (object, optional) — Ground-contact keypoints. Present only when `include_touch_points` is true. Coordinates are in processed-image pixels (same space as the returned PNG). Up to 4 unordered points.
• img_without_background_base64 (string, required) — Car cutout as Base64 PNG (RGBA) with transparent background. Shadow is not baked in; use `shadow_base64` to composite yourself. Prepend `data:image/png;base64,` to display in a browser.
• shadow_base64 (string, required) — Soft cast-shadow mask as Base64 grayscale PNG (0 = no shadow, 255 = full shadow). Not composited into the cutout; for client-side editing/compositing. Prepend `data:image/png;base64,` to display in a browser.

Errors#

Example (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-layers-base64"