Image

Bria Replace Object

Credit-based pricing. Supports reference images, batch up to 4.

Try Bria Replace Object →Compare models

Output

image

Max batch

Inputs

Reference image (required)

Batch up to 4 per request

Example prompt

a modern black leather office chair

Try this prompt →

LLM-ready

API & LLM schema

Exact request contract for this model. Agents can fetch it from /api/v1/models?id=bria/gen-fill/replace-object.

POST/api/v1/generate14 fields · 4 required

Field	Type	Requirement	Contract
`model_id`	constant	Required	ArtEmotion model identifier.
`extra`	object	Optional	Model-specific settings may also be nested here.
`max_credits`	number	Optional	Reject before submission if the estimated list price exceeds this cap. · Range: 1–…
`webhook_url`	string	Optional	Format: uri
`webhook_secret`	string	Optional	Optional model input.
`folder_id`	string	Optional	Optional model input.
`prompt`	string	Required	Optional model input.
`mask_url`	string	Required	The URL of the binary mask image marking the object to replace. Use Draw mask to paint it over your image.
`negative_prompt`	string	Optional	Describe attributes to exclude from the replacement object. · Default:
`refine_prompt`	boolean	Optional	Let Bria auto-refine your prompt for better fills. · Default: true
`preserve_alpha`	boolean	Optional	When enabled, preserves the alpha channel of the input image. Bria's API default. · Default: true
`seed`	integer	Optional	Same seed + same prompt = same image every time. Leave empty for a random seed.
`num_images`	integer	Optional	Range: 1–4
`reference_image_url`	string	Required	Format: uri

Minimal request example

{
  "model_id": "bria/gen-fill/replace-object",
  "prompt": "a modern black leather office chair",
  "mask_url": "your_mask_url",
  "reference_image_url": "https://example.com/reference_image"
}

Raw JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://www.artemotion.ai/api/v1/models?id=bria%2Fgen-fill%2Freplace-object",
  "title": "Bria Replace Object generation request",
  "description": "Request body accepted by POST /api/v1/generate for bria/gen-fill/replace-object.",
  "type": "object",
  "properties": {
    "model_id": {
      "type": "string",
      "const": "bria/gen-fill/replace-object",
      "description": "ArtEmotion model identifier."
    },
    "extra": {
      "type": "object",
      "additionalProperties": true,
      "description": "Model-specific settings may also be nested here."
    },
    "max_credits": {
      "type": "number",
      "minimum": 1,
      "description": "Reject before submission if the estimated list price exceeds this cap."
    },
    "webhook_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048
    },
    "webhook_secret": {
      "type": "string",
      "maxLength": 512
    },
    "folder_id": {
      "type": "string"
    },
    "prompt": {
      "type": "string"
    },
    "mask_url": {
      "title": "Mask Url",
      "description": "The URL of the binary mask image marking the object to replace. Use Draw mask to paint it over your image.",
      "type": "string"
    },
    "negative_prompt": {
      "title": "Negative Prompt",
      "description": "Describe attributes to exclude from the replacement object.",
      "default": "",
      "type": "string"
    },
    "refine_prompt": {
      "title": "Refine Prompt",
      "description": "Let Bria auto-refine your prompt for better fills.",
      "default": true,
      "type": "boolean"
    },
    "preserve_alpha": {
      "title": "Preserve Alpha",
      "description": "When enabled, preserves the alpha channel of the input image. Bria's API default.",
      "default": true,
      "type": "boolean"
    },
    "seed": {
      "title": "Seed",
      "description": "Same seed + same prompt = same image every time. Leave empty for a random seed.",
      "type": "integer",
      "multipleOf": 1
    },
    "num_images": {
      "type": "integer",
      "minimum": 1,
      "maximum": 4
    },
    "reference_image_url": {
      "type": "string",
      "format": "uri"
    }
  },
  "required": [
    "model_id",
    "prompt",
    "mask_url",
    "reference_image_url"
  ],
  "additionalProperties": false
}

Browse schemas for every ArtEmotion model →

FAQ

How much does Bria Replace Object cost on ArtEmotion?

Credit-based pricing. You pay in ArtEmotion credits — every plan and top-up converts USD to credits at a fixed rate.

Do I get my credits back if Bria Replace Object fails?

Yes — failed generations are never charged. The credits are released back to your balance automatically.

Can I call Bria Replace Object from the API?

Yes. Use POST /api/v1/generate with model_id: "bria/gen-fill/replace-object". See the API reference for the full schema.

Where are my generations stored?

Every output is saved to your personal Library. You can export or delete everything any time from Privacy & deletion.

Ready to generate with Bria Replace Object?

Start now →

No commitment. New accounts get 50 free credits on signup. See pricing.