ImageBackground Removal
Background Remover
Upload a picture and download it with the background removed.
BiRefNet by Peng Zheng and contributors
Model licenses
BiRefNet standard 1024 ONNX exports · MIT
Retain the original copyright, MIT permission notice and warranty disclaimer with all copies or substantial portions.
API reference
Submit via REST
Use your personal API key (msk_…) to create jobs for this workload from your own tools. Jobs started this way run on the same devices you connected on Your Devices — at least one has to be online.
https://cp.meshlabs.cloud/v1/organizations/jobsAuthenticate with X-Organization-Api-Key: msk_your_personal_api_key. The header name matches org keys; personal keys use the same endpoint.
POST https://cp.meshlabs.cloud/v1/organizations/job-inputs/presign with the same API key, upload your file to the returned upload_url, then pass download_url in job_spec (for example as input_image_url).Request body
{
"workload_type": "birefnet-1024",
"job_spec": {
"input_image_url": "https://…/your-input.png",
"resolution": 1024
}
}job_spec fields
| Field | Required | Default | Description |
|---|---|---|---|
input_image_url | Yes | — | Presigned S3 URL of the input image |
cURL
curl -X POST https://cp.meshlabs.cloud/v1/organizations/jobs \
-H "X-Organization-Api-Key: msk_your_personal_api_key" \
-H "Content-Type: application/json" \
-d '{
"workload_type": "birefnet-1024",
"job_spec": {
"input_image_url": "https://…/your-input.png",
"resolution": 1024
}
}'https://cp.meshlabs.cloud/v1/organizations/jobs/{job_id}Poll with the same API key until status is terminal (COMPLETED, FAILED, CANCELED, or MODERATION_BLOCKED). When content moderation is enabled, jobs may start in MODERATION_PENDING before entering the compute queue. Completed jobs include presigned download_url values on each output.
Create response
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"workload_type": "birefnet-1024",
"status": "PENDING",
"job_spec_json": {
"input_image_url": "https://…/your-input.png",
"resolution": 1024
},
"work_units": [],
"outputs": [],
"created_at": "2026-06-08T12:00:00Z",
"updated_at": "2026-06-08T12:00:00Z"
}Completed response
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"workload_type": "birefnet-1024",
"status": "COMPLETED",
"job_spec_json": {
"input_image_url": "https://…/your-input.png",
"resolution": 1024
},
"work_units": [
{
"id": "…",
"index": 0,
"status": "COMPLETED"
}
],
"outputs": [
{
"id": "…",
"output_type": "<output type>",
"filename": "<output filename>",
"size_bytes": 524288,
"download_url": "<presigned output download URL>"
}
],
"created_at": "2026-06-08T12:00:00Z",
"updated_at": "<completion timestamp>"
}Upload a picture and download a cutout with the background removed. Free background remover on devices you connect. The first run downloads the model; later pictures start faster.