Remove the background from an image. Returns the processed image URL.
Type: Async
Usage
simplified image:remove-background --url <image-url> [--wait]Options
| Flag | Type | Required | Description |
|---|---|---|---|
--url | string | ✅ | Public URL of the source image |
--wait | boolean | Block until complete (timeout: 120s) |
Examples
# Return task_id immediately
simplified image:remove-background --url "https://example.com/photo.jpg"
# Block and return result URL
simplified image:remove-background --url "https://example.com/photo.jpg" --wait
# Pipeline: remove background then post
URL=$(simplified image:remove-background --url "https://example.com/photo.jpg" --wait | jq -r '.url')
simplified posts:create -c "Clean shot" -a "ACCOUNT_ID" --action add_to_queue --media "$URL"Response (with --wait)
{ "url": "https://cdn.simplified.com/result.png" }Response (without --wait)
{ "task_id": "abc123" }Use image:task --id abc123 to poll status.