Object Removal API
Clutter can sink an otherwise usable photo. The Roomagen Object Removal API takes unwanted items out of a photo (personal belongings, a car on the driveway, bins, signs, a dated piece of furniture) and reconstructs what was behind them. Leave out options for an automatic clutter pass, or name what to remove in plain text; jobs are typically ready in 20–60 seconds.
演示示例：输入图片由 AI 为本网站生成，并非客户照片。
Who builds with this endpoint
Real-estate photography
Declutter occupied-home listing photos at scale: personal items, pet gear and countertop mess come out, and your prompt can say what must stay.
Secondhand marketplaces
Isolate the item being sold by removing background clutter from seller photos, making peer-to-peer listings look closer to retail quality.
Hotel room photography
Strip housekeeping carts, cords and staff reflections from room and suite photos, keeping brand imagery clean across hundreds of properties.
Construction and site photos
Take equipment, bins and vehicles out of progress photos used for marketing, and keep the unedited originals for your records.
One request, one webhook
Submit a job with the item-removal tool, get a job id, receive a webhook when the result is ready.
$ curl -X POST https://api.roomagen.com/api/v1/jobs \-H "X-Api-Key: rmg_live_..." \-H "Content-Type: application/json" \-d '{"tool": "item-removal","image_url": "https://example.com/photo.jpg","options": {"tier":"custom","customPrompt":"remove the boxes and the laundry basket"},"webhook_url": "https://yourapp.com/hooks/roomagen"}'# → { "job_id": "3f1c9d4e-…", "status": "processing", "images_charged": 1, "warnings": [] }
Every option of item-removal in the docs → · All documented tools
Prepaid, per image
Up and running in minutes
Create a key, send one POST, get the finished image back. No sales call, no onboarding queue.
- 1
Create your key
Sign in to the developer portal and generate a key. It is shown once, so store it somewhere safe.
developers.roomagen.com/portal ↗ - 2
Run your first job
One POST with a tool slug and your image. It returns immediately with a job id — generation runs in the background.
$ curl -X POST https://api.roomagen.com/api/v1/jobs \-H "X-Api-Key: rmg_live_..." \-H "Content-Type: application/json" \-d '{ "tool": "item-removal","image_url": "https://example.com/photo.jpg","options": { "tier": "custom", "customPrompt": "remove the boxes and the laundry basket" } }'# → 201 { "job_id": "3f1c9d4e-…", "status": "processing", "images_charged": 1, "warnings": [] } - 3
Get the result
Set a webhook_url and we call you when the image is ready, or poll the job endpoint. Typically 20–60 seconds.
POST → your webhook_urlGET /api/v1/jobs/{id}
✓ 50 free images on your first key, watermarked until you buy a pack · no card required