Bria Build is the developer platform behind Bria: REST APIs, a Python SDK, an MCP server and agent skills, all backed by the Fibo model family and trained only on licensed data. This page maps the capabilities to endpoint families. Every endpoint page in the reference has a schema, examples, generated code samples and a link to try it in the sandbox.
Generate photos and illustrations from text, a reference image, or a structured prompt. Fibo 2 translates your input into a VGL structured prompt (JSON) and renders from it, so every generation is inspectable and reproducible.
| Endpoint | Use it for |
|---|---|
POST /v2/image/generate | Standard pipeline: highest fidelity and instruction adherence. Text, image, or structured-prompt inputs. |
POST /v2/image/generate/lite | Fibo Lite: faster, and available for on-premises deployment. |
POST /v2/structured_prompt/generate | Only the translation step: get the structured prompt to inspect, edit or store. |
POST /v2/structured_prompt/generate/lite | The same, with the open FIBO-VLM bridge. |
POST /v2/structured_prompt/generate_from_diff | Repair or update a structured prompt after a user edited it. |
Overview · Best practices · API reference
Edit existing images with natural language, structured instructions, or focused single-purpose tools. All under POST /v2/image/edit/... unless noted.
| Group | Endpoints |
|---|---|
| Instruction editing (Fibo 2) | /v2/image/edit (1 to 4 images, optional mask), /v2/structured_instruction/generate |
| Object-level edits | add_object_by_text, replace_object_by_text, erase_by_text, remove_object, rewrite_text, blend |
| Style, light and season | restyle, relight, reseason, colorize, sketch_to_colored_image, restore |
| Backgrounds and layout | remove_background, replace_background, blur_background, erase_foreground, crop_foreground, expand |
| Mask-based precision | erase, gen_fill, /v2/image/segment/all_masks (segments every region into an individual mask; replaces the deprecated v1 /objects/mask_generator) |
| Resolution | enhance, increase_resolution |
Overview · Best practices · API reference
Commerce-grade product imagery: clean cutouts, packshots with consistent shadows, lifestyle scenes from text or a reference image, products integrated into scenes, product holding, virtual try-on, and automotive tools.
| Family | Endpoints |
|---|---|
| Catalog basics | /v1/product/cutout, /v1/product/packshot, /v1/product/shadow |
| Lifestyle scenes | /v1/product/lifestyle_shot_by_text, /v1/product/lifestyle_shot_by_image |
| Product editing | /v2/image/edit/product/cutout, /v2/image/edit/product/integrate, /v2/image/edit/product/holding, /v2/image/edit/product/virtual-tryon |
| Automotive | /v1/product/vehicle/shot_by_text, segment, generate_reflections, refine_tires, apply_effect, harmonize |
Overview · Best practices · API reference
Transform finite video files over REST, or process live streams frame by frame over WebSocket.
| Group | Endpoints |
|---|---|
| Editing (REST, async) | /v2/video/edit/erase, remove_background, replace_background, green_screen, increase_resolution (up to 8K) |
| Masking (REST, async) | /v2/video/segment/mask_by_prompt, mask_by_key_points, foreground_mask |
| Upload | POST /v2/video/upload for local files (Video Upload Service) |
| Streaming (WebSocket) | wss://streaming.prod.bria-api.com (Streaming Background Removal) |
| Capability | Endpoints |
|---|---|
| Ad Delayer (v2) | POST /v2/ads/delayer: a flat ad becomes editable layers with typography, cutouts and vector shapes. API reference |
| Ad Resize (v2) | POST /v2/ads/resize: a flat ad comes back at up to ten other sizes, the layout redone for each shape. API reference |
| Capability | Endpoints |
|---|---|
| Visual Verification | POST /v2/image/verify, POST /v2/video/verify: public endpoints that read Bria's C2PA manifest and invisible watermark. Overview · API reference |
| Attribution Service | /v2/image/attribution/by_image, /by_embedding, /v2/video/attribution/by_video, /by_embedding: attribute outputs to the licensed training data behind them. Overview · API reference |
Read more in Safety and transparency.
| Service | What it does |
|---|---|
| status endpoint | GET /v2/status/{request_id}: track every asynchronous job. |
| webhooks | Signed POST callbacks when a job completes; no polling. |
| Rate limits and errors | Plan limits and the error contract. |
Bria's models and pipelines run in Bria's cloud by default. Enterprise customers can run selected pipelines inside their own cloud account or on-premises, with attribution and licensing preserved. See Deployment options.