Extract Object
bria/extract-objectGenerate and edit images from text with Extract Object from fal through one Spiral API key. It runs in the background and returns images. Pay as you go, with no subscription.
Pricing
$0.026 per image.
Limits
- Runs
- In the background
- Returns
- image
- Longest queue wait
- 1 hour
- Run deadline
- 30 minutes
- Longest run, end to end
- 225 minutes
- Largest inline input
- 1 MB
- Largest input file
- 2 GB
- Largest output
- 5 GB
Input
| Field | Kind | Default | Description |
|---|---|---|---|
image_url | URL or file | https://bria-datasets.s3.amazonaws.com/object-extraction/tools_construction_flatlay.jpg | Source image as a public URL, a base64 data URI (data:image/png;base64,...) or raw base64-encoded image bytes. |
prompt | text | yellow hammer | Natural-language description of the object to act on, e.g. 'the red car'. |
autocrop | true or false | false | Tighten the output canvas to the extracted object. |
remove_background | true or false | false | When True, refine the cutout alpha with background removal (RMBG). When False (default), use the SAM segmentation mask as the cutout's alpha -- faster, with no salient-object matting (helpful when RMBG over-trims text, logos, or graphics). |
Same request in code
curl https://api.spiral.ai/v1/runs \
-H "Authorization: Bearer $SPIRAL_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"provider": "fal",
"model": "bria/extract-object",
"input": {
"image_url": "https://bria-datasets.s3.amazonaws.com/object-extraction/tools_construction_flatlay.jpg"
}
}'Frequently asked questions
How much does Extract Object cost?
$0.026 per image. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.
How do I use Extract Object through an API?
Send `POST /v1/runs` with `"provider": "fal"`, `"model": "bria/extract-object"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.
Do I need an account with fal to use Extract Object?
No. Spiral runs it on its own fal account and charges your Spiral balance.
Can my AI agent use Extract Object?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.