{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Overview","siteUrl":"https://docs.bria.ai","llmstxt":{"hide":false,"title":"Bria AI API","description":"bria.ai helps you build products and workflows by delivering controllable, easy-to-integrate and safe generative visual AI capabilities.","details":{"path":"_llmstxt-details.md"},"sections":[{"title":"Integrations","description":"MCP server, Claude Skill, and Python SDK.","includeFiles":["MCP-authentication.md","integration-methods/bria-skill.md","integration-methods/python-sdk.md"],"excludeFiles":[]},{"title":"Getting Started","description":"Authentication, API overview, and platform concepts.","includeFiles":["index.md","products-overview.md","safety.md","vgl.md","best-practices-overview.md"],"excludeFiles":[]},{"title":"Image Generation","description":"Generate images using text prompts or structured JSON via FIBO models.","includeFiles":["image-generation.md","image-generation.yaml"],"excludeFiles":[]},{"title":"Image Editing","description":"Edit, transform, and enhance images with 20+ specialized endpoints.","includeFiles":["image-editing.md","image-editing.yaml"],"excludeFiles":[]},{"title":"Video Editing","description":"Remove backgrounds (REST async or real-time streaming), erase objects, upscale, and generate masks for video.","includeFiles":["video-editing.md","local-video-upload-service.md","video-editing.yaml","streaming-rmbg.md"],"excludeFiles":[]},{"title":"Product Shot Editing","description":"SKU packshots, lifestyle scenes, and automotive product imagery.","includeFiles":["product-shot-editing.md","product-shot-editing.yaml"],"excludeFiles":[]},{"title":"Optional","description":"Tailored generation, ads, image onboarding, and attribution.","includeFiles":["tailored-generation.md","campaign-generation.md","image-onboarding.md","bria-attribution-service.md","ad-generation.md","tailored-generation.yaml","campaign-generation.yaml","image-onboarding.yaml","bria-attribution-service.yaml","ad-generation.yaml"],"excludeFiles":[]}],"excludeFiles":["_llmstxt-details.md","_partials.md","CHANGELOG.md"]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"overview","__idx":0},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Bria's Image Editing API equips builders with a comprehensive suite of tools for manipulating and enhancing images. Powered by the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["FIBO models family"]},", the API supports everything from open-ended natural language edits to highly controlled, deterministic JSON workflows."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"core-capabilities","__idx":1},"children":["Core Capabilities"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"general-image-editing-fibo-edit","__idx":2},"children":["General Image Editing (FIBO Edit)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Our newest ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v2"]}," endpoints enable powerful editing using either natural language instructions or strict JSON structures."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Global Edits:"]}," Modify the style, lighting, or atmosphere of an entire image."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Localized Edits:"]}," Utilize native masking support for precise regional edits. The masking logic acts as a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["generative replacement"]},", creating entirely new content within the masked area based on your instruction without altering the surrounding pixels."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Disentangled Control:"]}," Convert text instructions into a detailed ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["structured_instruction"]}," (JSON) to achieve deterministic, auditable, and reproducible results."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"the-fibo-architecture","__idx":3},"children":["The FIBO Architecture"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The primary ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v2/image/edit"]}," endpoint utilizes a unique two-step process:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Translation:"]}," A VLM Bridge (powered by Gemini 2.5 Flash) converts your inputs (text + image/mask) into a detailed JSON ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["structured_instruction"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Generation:"]}," The FIBO Edit model performs the final, deterministic render based on that JSON."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Developers can decouple this process by using the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v2/structured_instruction/generate"]}," endpoint to intercept, edit, or programmatically build the JSON before passing it to the final render step."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"specialized-single-purpose-tools","__idx":4},"children":["Specialized Single-Purpose Tools"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For focused, high-volume tasks, the API provides optimized endpoints:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Background Operations:"]}," Remove, replace, or blur backgrounds (powered by Bria RMBG 2.0)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Content Manipulation:"]}," Erase objects or perform generative fill."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Image Transformation:"]}," Expand (outpaint) images to specific aspect ratios or increase resolution safely."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Person/Object Tools:"]}," Extract masks or modify presenter attributes."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"asynchronous-processing","__idx":5},"children":["Asynchronous Processing"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["By default, all Bria ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v2"]}," endpoints process requests asynchronously. The API will immediately return a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["request_id"]}," and a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status_url"]}," instead of the final result. You must poll the Status Service to track progress."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ℹ️ Need synchronous responses?"]}," > If your integration is simple and low-throughput, you can pass ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sync: true"]}," in your request body to hold the connection open until the final image URL is returned."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.bria.ai/status"},"children":["View the Status Service Documentation"]}," for complete polling details and usage examples."]}]},"headings":[{"value":"Overview","id":"overview","depth":1},{"value":"Core Capabilities","id":"core-capabilities","depth":2},{"value":"General Image Editing (FIBO Edit)","id":"general-image-editing-fibo-edit","depth":3},{"value":"The FIBO Architecture","id":"the-fibo-architecture","depth":3},{"value":"Specialized Single-Purpose Tools","id":"specialized-single-purpose-tools","depth":3},{"value":"Asynchronous Processing","id":"asynchronous-processing","depth":3}],"frontmatter":{"seo":{"title":"Overview"}},"lastModified":"2026-03-19T10:59:29.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/image-editing-overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}