bria/expand
Expand by Bria - AI-powered image editing, style transfer, and transformation. Edit photos with natural language instructions, remove backgrounds, change styles, and enhance images effortlessly.
PNG, JPEG, WebP, or GIF · 20 MiB maximum
Example output — click Run to generate your own
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
https://api.sandbase.ai/v1/runbria/expandInput Schema
7 parameters · 2 required · 5 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
image | string | Required | The URL of the input image. |
prompt | string | Required | Text on which you wish to base the image expansion. This parameter is optional. Bria currently supports prompts in English only, excluding special characters. · Default: "" |
seed | integer | Optional | You can choose whether you want your generated expension to be random or predictable. You can recreate the same result in the future by using the seed value of a result from the response. You can exclude this parameter if you are not interested in recreating your results. This parameter is optional. · Min: 0 · Max: 2147483647 |
canvas_size | integer[] | Optional | The desired size of the final image, after the expansion. should have an area of less than 5000x5000 pixels. |
aspect_ratio | string | Optional | The aspect ratio of the generated image. · Options: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16 21:916:93:24:35:41:14:53:42:39:16 |
original_image_size | integer[] | Optional | The desired size of the original image, inside the full canvas. Ensure that the ratio of input image foreground or main subject to the canvas area is greater than 15% to achieve optimal results. Will be ignored if aspect_ratio is provided. |
original_image_location | integer[] | Optional | The desired location of the original image, inside the full canvas. Provide the location of the upper left corner of the original image. The location can also be outside the canvas (the original image will be cropped). Will be ignored if aspect_ratio is provided. |
Output Schema
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the generation task |
status | string | Task status: pending, running, completed, failed, timeout |
model | string | Model used for the generation |
outputs | array | Array of output items |
outputs[].url | string | URL of the generated artifact |
outputs[].content_type | string | MIME type (e.g. image/png, video/mp4) |
error | object | null | Error details if failed, null on success |
error.type | string | Machine-readable error type code |
error.message | string | Human-readable error description |
Async Workflow
This model uses asynchronous execution. Submit a request and poll for the result.
- Submit — POST to /v1/run, receive an
id - Poll — GET /v1/run/{id} until status is
completed,failed, ortimeout - Retrieve — Read
outputsfrom the completed response
Code Examples
Ready-to-run snippets
# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "bria/expand",
"image": "https://static.sandbase.ai/examples/bria/expand/input_image_0.png",
"prompt": "a beautiful sunset over mountains",
"canvas_size": [
1200,
674
],
"original_image_size": [
610,
855
],
"original_image_location": [
301,
-66
]
}'
# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
-H "Authorization: Bearer YOUR_API_KEY"API README
Bria Expand
Bria Expand is built for outpainting beyond an image boundary to create a larger, coherent canvas. It gives creative and production teams a focused way to move from an approved brief or source asset to a reviewable result without fragmenting the job across unrelated tools. The model is most valuable when visual intent, brand suitability, and downstream usability all matter, because its output can enter an editorial, campaign, product, or content pipeline as a purposeful asset rather than an isolated experiment.
In practice, teams can use Bria Expand during a structured cycle of briefing, generation, comparison, and refinement. Establish the subject, audience, visual objective, and acceptance criteria first; prepare any reference media at suitable quality; then evaluate alternatives for composition, continuity, realism, and communication value before delivery. This workflow keeps creative judgment central while making repeated production easier to review, reproduce, and scale for the specific bria/expand task.
Highlights
Boundary-aware outpainting. Boundary-aware outpainting gives bria › expand a recognizable technical advantage: reviewers can assess this property directly in the generated asset instead of inferring it from request mechanics.
Scene continuation. bria › expand applies scene continuation to the visual or temporal result itself, helping artists make a meaningful quality decision during selection and refinement.
Flexible canvas expansion. For bria › expand, flexible canvas expansion supports coherent assets across the intended creative workflow and distinguishes this capability from a simple format or delivery option.
Original center preservation. The practical value of original center preservation is visible in the finished media from bria › expand, where it supports repeatable art direction rather than merely exposing another request setting.
Pricing
| Billing basis | Price |
|---|---|
| Per request | $0.040000 |
When to Use
| ✅ Good fit | ❌ Consider alternatives |
|---|---|
| Use it when outpainting beyond an image boundary to create a larger, coherent canvas is the central production goal | Choose a different model when the required media task is fundamentally different |
| The team needs several reviewable creative alternatives | Exact deterministic reproduction is mandatory |
| Visual quality and practical downstream use both matter | Editable source layers or native project files are required |
| A managed generation step fits the delivery workflow | A live frame-by-frame interactive editor is essential |
| The documented inputs cover the available source assets | Required source media or controls fall outside the documented fields |
Prompt Guide
State the intended result first, then describe the subject, environment, action, visual treatment, and delivery constraints. Keep instructions concrete, avoid conflicting directions, and change one creative variable at a time when comparing outputs. For source-driven work, describe what should remain recognizable as clearly as what should change.
{
"image": "https://static.sandbase.ai/examples/bria/expand/input_image_0.png",
"prompt": ""
}
Technical Specs
| Property | Details |
|---|---|
seed | Type / options: integer · 0–2147483647<br>Required: No<br>Description: You can choose whether you want your generated expension to be random or predictable. You can recreate the same result in the future by using the seed value of a result from the response. You can exclude this parameter if you are not interested in recreating your results. This parameter is optional. |
image | Type / options: string<br>Required: Yes<br>Description: The URL of the input image. |
prompt | Type / options: string<br>Required: Yes<br>Description: Text on which you wish to base the image expansion. This parameter is optional. Bria currently supports prompts in English only, excluding special characters. |
canvas_size | Type / options: array<br>Required: No<br>Description: The desired size of the final image, after the expansion. should have an area of less than 5000x5000 pixels. |
aspect_ratio | Type / options: string · 21:9 / 16:9 / 3:2 / 4:3 / 5:4 / 1:1 / 4:5 / 3:4 / 2:3 / 9:16<br>Required: No<br>Description: The aspect ratio of the generated image. |
original_image_size | Type / options: array<br>Required: No<br>Description: The desired size of the original image, inside the full canvas. Ensure that the ratio of input image foreground or main subject to the canvas area is greater than 15% to achieve optimal results. Will be ignored if aspect_ratio is provided. |
original_image_location | Type / options: array<br>Required: No<br>Description: The desired location of the original image, inside the full canvas. Provide the location of the upper left corner of the original image. The location can also be outside the canvas (the original image will be cropped). Will be ignored if aspect_ratio is provided. |
Related Models
bria/background/removebria/background/replacebria/embed-product
