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.

Distributed license

Notice

FreeOnlineUnlimitedBiRefNet by Peng Zheng and contributors API access

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.

Hide API details
POSThttps://cp.meshlabs.cloud/v1/organizations/jobs

Authenticate with X-Organization-Api-Key: msk_your_personal_api_key. The header name matches org keys; personal keys use the same endpoint.

Input files:Call 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

FieldRequiredDefaultDescription
input_image_urlYes—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
  }
}'
GEThttps://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.