Model API

Bria Extract Object

Bria Extract Object isolates the object you name from an image and returns it as a PNG with a transparent background. Made for product, ecommerce, advertising and creative editing work.

Model id

Use this in every request

bria/extract-object

Run it

Quote the input, start the generation with the quote, then poll the job. Set RAYWAKE_API_KEY first; see Authentication.

# 1. Price the exact input (quotes are valid for up to 10 minutes)
curl -s https://api.raywake.com/v1/quotes \
  -H "Authorization: Bearer $RAYWAKE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "bria/extract-object",
  "input": {
    "image_url": "https://example.com/input.png",
    "prompt": "A red ceramic cup on a wooden table, soft morning light"
  }
}'

# 2. Start the generation with the quote_id from step 1
curl -s https://api.raywake.com/v1/generate \
  -H "Authorization: Bearer $RAYWAKE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"model": "bria/extract-object", "quote_id": "QUOTE_ID", "input": {"image_url":"https://example.com/input.png","prompt":"A red ceramic cup on a wooden table, soft morning light"}}'

# 3. Poll until the status is terminal
curl -s https://api.raywake.com/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $RAYWAKE_API_KEY"

Input

Input fields for bria/extract-object
Name	Type	Description
`image_url`required	string (image URL)	Source image as a public URL, a base64 data URI (data:image/png;base64,...) or raw base64-encoded image bytes.
`prompt`required	string	Natural-language description of the object to act on, e.g. 'the red car'.
`sync_mode`	boolean	If true, the function waits for the image to be generated and uploaded before returning, so the image is returned directly (base64) instead of via the CDN. Increases latency. Default: `false`
`autocrop`	boolean	Tighten the output canvas to the extracted object. Default: `false`
`remove_background`	boolean	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). Default: `false`

Output

A succeeded job lists its results under outputs, stored on our side. See Jobs for every field.

Job excerpt

"outputs": [
  { "type": "image", "url": "https://…", "mime_type": "image/png", "thumbnail_url": "https://…" }
]

Pricing

1 image$0.04/ image

The exact charge for your input comes from a quote. How charges settle