Bria Product Cutout Serverless API
Automates precise product cutouts and background removal for professional eCommerce imagery at scale.
1import requests
2import json
3
4url = "https://api.segmind.com/v1/bria-product-cutout"
5headers = {
6 "x-api-key": "YOUR_API_KEY",
7 "Content-Type": "application/json"
8}
9
10data = {
11 "sku": "PROD12345",
12 "image_url": "https://segmind-resources.s3.amazonaws.com/input/ecc737f0-3a66-4436-a93e-1ab6313cae71-62006b85ffb96123cd785999663958cc.jpeg",
13 "force_rmbg": true,
14 "preserve_alpha": true
15}
16
17response = requests.post(url, headers=headers, json=data)
18
19if response.status_code == 200:
20 result = response.json()
21 print(json.dumps(result, indent=2))
22else:
23 print(f"Error: {response.status_code}")
24 print(response.text) 1import requests
2import json
3
4url = "https://api.segmind.com/v1/bria-product-cutout"
5headers = {
6 "x-api-key": "YOUR_API_KEY",
7 "Content-Type": "application/json"
8}
9
10data = {
11 "sku": "PROD12345",
12 "image_url": "https://segmind-resources.s3.amazonaws.com/input/ecc737f0-3a66-4436-a93e-1ab6313cae71-62006b85ffb96123cd785999663958cc.jpeg",
13 "force_rmbg": true,
14 "preserve_alpha": true
15}
16
17response = requests.post(url, headers=headers, json=data)
18
19if response.status_code == 200:
20 result = response.json()
21 print(json.dumps(result, indent=2))
22else:
23 print(f"Error: {response.status_code}")
24 print(response.text)API Endpoint
https://api.segmind.com/v1/bria-product-cutoutParameters
content_moderationoptionalbooleanApplies moderation to input/output images. Use true for sensitive environments.
falseforce_rmbgoptionalbooleanForce removes background even with existing alpha channel. Use true for cleaner separation.
trueimage_urloptionalstring (uri)Link to product image for processing. Check the format to ensure compatibility.
"https://segmind-resources.s3.amazonaws.com/input/ecc737f0-3a66-4436-a93e-1ab6313cae71-62006b85ffb96123cd785999663958cc.jpeg"preserve_alphaoptionalbooleanRetains original transparency if available. Set to false for a solid background.
trueskuoptionalstringUnique identifier for your product. Suggested format: alphanumeric code.
"PROD12345"Response Type
Returns: Image
Common Error Codes
The API returns standard HTTP status codes. Detailed error messages are provided in the response body.
Bad Request
Invalid parameters or request format
Unauthorized
Missing or invalid API key
Forbidden
Insufficient permissions
Not Found
Model or endpoint not found
Insufficient Credits
Not enough credits to process request
Rate Limited
Too many requests
Server Error
Internal server error
Bad Gateway
Service temporarily unavailable
Timeout
Request timed out