Bria Expand Image Serverless API

Bria Expand enables precise image manipulation and enhancement with generative AI, trained exclusively on licensed data for safe, risk-free commercial use.

~13.58s

$0.04 per generation

Playground API

Pricing

~13.58s

$0.04 per generation

 1import requests
 2import json
 3
 4url = "https://api.segmind.com/v1/bria-expand-image"
 5headers = {
 6    "x-api-key": "YOUR_API_KEY",
 7    "Content-Type": "application/json"
 8}
 9
10data = {
11    "image": "https://segmind-resources.s3.amazonaws.com/input/3f05def3-776b-4944-a0f6-c23cec41a09e-cbf61f2b859662c0.jpg",
12    "aspect_ratio": "4:3",
13    "prompt_content_moderation": true,
14    "seed": 12345,
15    "negative_prompt": "Do not include buildings or modern architecture",
16    "preserve_alpha": true,
17    "visual_input_content_moderation": false,
18    "visual_output_content_moderation": false
19}
20
21response = requests.post(url, headers=headers, json=data)
22
23if response.status_code == 200:
24    result = response.json()
25    print(json.dumps(result, indent=2))
26else:
27    print(f"Error: {response.status_code}")
28    print(response.text)

 1import requests
 2import json
 3
 4url = "https://api.segmind.com/v1/bria-expand-image"
 5headers = {
 6    "x-api-key": "YOUR_API_KEY",
 7    "Content-Type": "application/json"
 8}
 9
10data = {
11    "image": "https://segmind-resources.s3.amazonaws.com/input/3f05def3-776b-4944-a0f6-c23cec41a09e-cbf61f2b859662c0.jpg",
12    "aspect_ratio": "4:3",
13    "prompt_content_moderation": true,
14    "seed": 12345,
15    "negative_prompt": "Do not include buildings or modern architecture",
16    "preserve_alpha": true,
17    "visual_input_content_moderation": false,
18    "visual_output_content_moderation": false
19}
20
21response = requests.post(url, headers=headers, json=data)
22
23if response.status_code == 200:
24    result = response.json()
25    print(json.dumps(result, indent=2))
26else:
27    print(f"Error: {response.status_code}")
28    print(response.text)

API Endpoint

POSThttps://api.segmind.com/v1/bria-expand-image

Parameters

imagerequired

string (uri)

Input image for processing. Use an accessible URL or Base64 string.

Default: "https://segmind-resources.s3.amazonaws.com/input/3f05def3-776b-4944-a0f6-c23cec41a09e-cbf61f2b859662c0.jpg"

aspect_ratiooptional

string

Defines image aspect ratio. For landscapes use 16:9, for portraits use 2:3.

Default: "4:3"

Allowed values :

"1:1""2:3""3:2""3:4""4:3""4:5""5:4""9:16""16:9"

negative_promptoptional

string

Excludes elements in generating image. Use 'cityscapes' to avoid urban features.

Default: "Do not include buildings or modern architecture"

preserve_alphaoptional

boolean

Keeps transparency in images. Use with PNGs to maintain transparency.

Default: true

promptoptional

string

Text guidance for image expansion. Use keywords like 'sunset' or 'ocean'.

Default: null

prompt_content_moderationoptional

boolean

Scans prompt for NSFW content. Keep enabled for safe usage.

Default: true

seedoptional

integer

Sets randomization seed for reproducibility. Use any integer for consistency.

Default: 12345

visual_input_content_moderationoptional

boolean

Moderates input visuals for NSFW content. Enable for safer uploads.

Default: false

visual_output_content_moderationoptional

boolean

Moderates output visuals for NSFW content. Use to ensure clean results.

Default: false

Response Type

Returns: Image

Common Error Codes

The API returns standard HTTP status codes. Detailed error messages are provided in the response body.

400

Bad Request

Invalid parameters or request format

401

Unauthorized

Missing or invalid API key

403

Forbidden

Insufficient permissions

404

Not Found

Model or endpoint not found

406

Insufficient Credits

Not enough credits to process request

429

Rate Limited

Too many requests

500

Server Error

Internal server error

502

Bad Gateway

Service temporarily unavailable

504

Timeout

Request timed out