Self-hosted withoutBG v3 background removal API (CPU, ONNX, FastAPI).
3.3K
Self-hosted withoutBG open weights background removal API. Runs the v3 ONNX model on CPU with a FastAPI service — no GPU required.
docker run --rm -p 8000:8000 withoutbg/withoutbg-openweights-v3-service-cpu:latest
Health check: http://localhost:8000/health
Published for linux/amd64 and linux/arm64. Docker pulls the matching architecture automatically (Intel/AMD, Apple Silicon, AWS Graviton, etc.).
| Endpoint | Method | Description |
|---|---|---|
/health | GET | Liveness probe |
/ready | GET | Readiness probe (model loaded) |
/v1/remove-background | POST | Remove image background (raw image or multipart) |
/v1/licenses | GET | Model and dependency licenses |
/docs | GET | OpenAPI / Swagger UI |
Same input/output schema as the withoutBG Mac Local API: send a raw JPEG/PNG body (or multipart field image); response is image/png with header X-Latency-Ms. Use ?output=matte for a grayscale alpha matte instead of the default cutout.
curl -X POST \
--data-binary @photo.jpg \
-H "Content-Type: image/jpeg" \
http://127.0.0.1:8000/v1/remove-background \
-o result.png
curl -X POST "http://127.0.0.1:8000/v1/remove-background?output=matte" \
-H "Content-Type: image/png" \
--data-binary @photo.png \
-o matte.png
| Image | Use case |
|---|---|
withoutbg/withoutbg-openweights-v3-service-gpu | Same API, GPU acceleration |
withoutbg/withoutbg-openweights-v3-app-cpu | Web UI + API (CPU) |
withoutbg/withoutbg-openweights-v3-app-gpu | Web UI + API (GPU) |
/v1/licenses in the running container)Content type
Image
Digest
sha256:4d507acca…
Size
926.9 MB
Last updated
2 months ago
docker pull withoutbg/withoutbg-openweights-v3-service-cpu