New: Official ComfyUI Partner Nodes Available

Edit Images with JSON + Mask
No Prompt Guessing

Fibo-Edit is Bria AI's structured image editing model. Combine JSON parameters + precise masks to make deterministic, reproducible edits with minimal drift. 100% licensed training data for commercial-safe outputs.

Open Weights on Hugging Face
REST API via fal.ai & Bria
Official ComfyUI Partner Nodes
100% Licensed Training Data
Commercial-Safe Outputs

What is Fibo Edit?

Fibo-Edit is Bria AI's JSON + Mask + Image structured instruction image editing model, built for controllable, reproducible, production-ready workflows.

JSON-Native Control

Define precise edit parameters with structured JSON prompts. No more guessing what the AI will do—specify exactly what you want changed.

Precise Mask Editing

Target specific regions with pixel-perfect masks. Edit only what you need while preserving the rest of your image intact.

Deterministic Output

Same input, same output—every time. Fibo-Edit eliminates prompt drift with reproducible results suitable for production pipelines.

Try Fibo Edit (Live Demo)

Experience structured AI image editing directly in your browser. Upload an image, define your edit, and see deterministic results instantly.

Use Cases by Industry

Fibo-Edit serves developers, designers, e-commerce teams, and ComfyUI power users with production-ready image editing capabilities.

E-Commerce Product Photo Editing

Transform product photography at scale. Generate color variants, swap backgrounds for lifestyle scenes, add professional lighting—all with consistent, reproducible results.

  • Generate SKU color variants automatically
  • Batch process thousands of images
  • 100% commercial-safe, licensed outputs
API for E-Commerce
Red
Blue
Green
Gold
Purple
Black

One product → 6 color variants in seconds

Marketing & Creative Teams

Create campaign variations without the prompt lottery. Fibo-Edit's deterministic output means you can iterate on creative concepts while maintaining brand consistency.

  • A/B test creative variations at scale
  • Maintain brand style consistency
  • Seasonal campaign adaptations
Try Live Demo
Campaign A

Summer vibes, warm tones, outdoor setting

Campaign B

Professional, cool tones, studio backdrop

Campaign C

Holiday theme, festive elements, warm lighting

Developers & API Integration

Build image editing into your applications with Fibo-Edit's comprehensive API. Structured JSON requests, async job handling, and webhook support for production workloads.

  • REST API with async job support
  • Webhook callbacks for batch processing
  • $0.04/image on fal.ai
View API Docs
Python
import fal_client

result = fal_client.subscribe(
    "fal-ai/bria/fibo-edit/edit",
    arguments={
        "image_url": "https://...",
        "prompt": "recolor to blue",
        "mask_url": "https://..."
    }
)
print(result["image"]["url"])

ComfyUI Workflow Integration

Fibo-Edit has official ComfyUI Partner Nodes. Build complex editing workflows with node-based visual programming and export reproducible JSON workflows.

  • Official Bria ComfyUI Partner Nodes
  • Downloadable workflow JSON templates
  • Test instantly on Comfy Cloud
ComfyUI Setup Guide

Load Image Node

Input source image

Fibo-Edit Node

JSON + Mask processing

Save Image Node

Export edited result

Key Capabilities (Relight, Recolor, Replace, Material, Style)

Fibo-Edit supports a comprehensive set of image editing operations, all controllable through structured JSON parameters.

AI Relight

Add professional studio lighting, adjust shadows, and change light direction without reshooting.

AI Recolor

Change object colors while preserving textures, reflections, and composition integrity.

Object Replace

Swap objects via text descriptions. Replace items in scene while maintaining visual coherence.

Material Swap

Transform textures and materials—matte to glossy, wood to metal, fabric to leather.

Style Transfer

Apply artistic styles and visual treatments while preserving subject identity.

Local Edits (Mask)

Target specific regions with pixel-perfect masks. Edit precisely what you need, nothing more.

How Fibo-Edit Works (Image + Mask + JSON → Output)

Fibo-Edit combines three inputs to produce deterministic, controllable image edits.

1

Upload Source Image

Provide the image you want to edit. Supports PNG, JPG, WebP formats up to 4096px.

2

Define Edit with JSON

Specify your edit using structured JSON parameters. Define color changes, lighting, materials, or text-based replacements.

3

Apply Mask (Optional)

For targeted edits, create a mask to specify exactly which region should be modified.

4

Generate Deterministic Output

Receive your edited image. Same inputs always produce the same output—no prompt lottery.

JSON Prompt Guide (VGL-Style Structured Edits)

Fibo-Edit uses Visual GenAI Language (VGL) for precise, interpretable edit commands. Here's how to structure your JSON prompts.

JSON Structure Explained

Core Parameters

  • image_url

    URL to source image (required). Must be publicly accessible.

  • prompt

    Natural language edit instruction. Be specific: "recolor the shirt to navy blue".

  • mask_url

    Optional. URL to mask image defining edit region. White = edit, Black = preserve.

  • num_inference_steps

    Denoising steps (default: 50). Higher = better quality, slower.

  • guidance_scale

    Prompt adherence (default: 5). Higher = stronger edit effect.

Effective Prompt Writing

  • Good: "recolor the car to metallic red"
  • Bad: "make it look better"
  • Good: "add warm studio lighting from the left"
  • Bad: "fix the lighting"
JSON
{
  "image_url": "https://example.com/product.jpg",
  "prompt": "recolor the sneakers to deep navy blue, keep the white sole",
  "mask_url": "https://example.com/mask.png",
  "num_inference_steps": 50,
  "guidance_scale": 5,
  "seed": 42
}
Response
{
  "image": {
    "url": "https://fal.media/files/...",
    "content_type": "image/png",
    "width": 1024,
    "height": 1024
  },
  "seed": 42,
  "timings": {
    "inference": 3.245
  }
}

Mask Editing: Precise Region Control

Masks let you target specific areas for editing while preserving the rest of your image. Here's how to create effective masks for Fibo-Edit.

Mask Format

White regions = areas to edit
Black regions = areas to preserve

Resolution Match

1024 × 1024

Mask dimensions must match your source image exactly. Mismatched sizes cause errors.

Feathered Edges

Soft mask edges create smoother blending. Hard edges can cause visible seams.

Common Mask Errors & Solutions

Error Cause Solution
Mask size mismatch Mask resolution ≠ image resolution Resize mask to match source image exactly
Edit bleeding Mask edges too soft/large Use tighter mask boundaries
Visible seams Mask edges too hard Add 2-5px feathering to edges
No edit applied Mask is all black (no edit region) Ensure white regions mark areas to edit

API Quickstart (Copy/Paste)

Get started with Fibo-Edit API in minutes. Choose your preferred language and copy the code.

cURL
# Fibo-Edit API via fal.ai
curl -X POST https://queue.fal.run/fal-ai/bria/fibo-edit/edit \
  -H "Authorization: Key $FAL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/input.jpg",
    "prompt": "recolor to vibrant blue",
    "mask_url": "https://example.com/mask.png",
    "num_inference_steps": 50,
    "guidance_scale": 5
  }'
Python
# pip install fal-client
import fal_client

# Set FAL_KEY environment variable or pass api_key
result = fal_client.subscribe(
    "fal-ai/bria/fibo-edit/edit",
    arguments={
        "image_url": "https://example.com/input.jpg",
        "prompt": "recolor to vibrant blue",
        "mask_url": "https://example.com/mask.png",
        "num_inference_steps": 50,
        "guidance_scale": 5
    },
    with_logs=True
)

print(result["image"]["url"])
JavaScript
// npm install @fal-ai/serverless-client
import * as fal from "@fal-ai/serverless-client";

fal.config({
  credentials: process.env.FAL_KEY
});

const result = await fal.subscribe("fal-ai/bria/fibo-edit/edit", {
  input: {
    image_url: "https://example.com/input.jpg",
    prompt: "recolor to vibrant blue",
    mask_url: "https://example.com/mask.png",
    num_inference_steps: 50,
    guidance_scale: 5
  },
  logs: true
});

console.log(result.image.url);

$0.04

per image on fal.ai

~3s

average inference time

Async

job queue with webhooks

API Schema Reference

Complete reference for Fibo-Edit API request and response schemas.

Request Schema

Parameter Type Required
image_url string Yes
prompt string Yes
mask_url string No
num_inference_steps integer No (default: 50)
guidance_scale float No (default: 5)
seed integer No (random)

Response Schema

Field Type Description
image.url string Output image URL
image.width integer Image width in pixels
image.height integer Image height in pixels
seed integer Seed used for generation
timings object Inference timing data

Async Job Pattern for Batch Processing

For production workloads, use the async pattern with webhooks to process large batches efficiently.

Python - Async Batch
import fal_client
import asyncio

async def process_batch(images):
    """Process multiple images asynchronously"""
    tasks = []
    
    for img in images:
        # Submit job to queue
        handler = fal_client.submit(
            "fal-ai/bria/fibo-edit/edit",
            arguments={
                "image_url": img["url"],
                "prompt": img["prompt"],
                "mask_url": img.get("mask")
            }
        )
        tasks.append(handler)
    
    # Wait for all results
    results = []
    for handler in tasks:
        result = handler.get()  # Blocks until complete
        results.append(result["image"]["url"])
    
    return results

# Usage
batch = [
    {"url": "https://...", "prompt": "recolor to red"},
    {"url": "https://...", "prompt": "recolor to blue"},
    {"url": "https://...", "prompt": "recolor to green"}
]
outputs = asyncio.run(process_batch(batch))

ComfyUI Partner Node (Official Integration)

Fibo-Edit has official ComfyUI nodes released January 2026. Build visual workflows with node-based programming.

Installation

Option 1: ComfyUI Manager

Search for "Bria" in ComfyUI Manager and install the official Bria nodes package.

Option 2: Manual Install

cd ComfyUI/custom_nodes
git clone https://github.com/Bria-AI/ComfyUI-BRIA-API
pip install -r requirements.txt

Option 3: Comfy Cloud

Test Fibo-Edit instantly on Comfy Cloud without local setup.

Available Nodes

BRIA Image Edit

Full Fibo-Edit capabilities with mask support

BRIA Outpainting

Extend images beyond original boundaries

BRIA Background Remove

RMBG 2.0 integration for background removal

Downloadable Workflows

Pre-built ComfyUI workflows for common Fibo-Edit use cases. Download, import, and customize.

Hugging Face Weights & Local Deployment

Fibo-Edit open weights are available on Hugging Face for local inference and research.

🤗

briaai/Fibo-Edit

8B parameter DiT model

1.6K+

Downloads

39

Likes

View on Hugging Face →

System Requirements

GPU VRAM 24GB+ recommended
Inference Steps 50 (default)
Guidance Scale 5 (default)
License CC BY-NC 4.0

CPU offloading supported for systems with less VRAM. Commercial use requires Bria AI license.

Deployment Options (Cloud / Local / Hybrid)

Choose the deployment model that fits your infrastructure and compliance requirements.

Recommended

Cloud API

Fastest setup. Use fal.ai or Bria Platform APIs for serverless inference with no infrastructure management.

  • No infrastructure setup
  • Auto-scaling
  • Pay per image
fal.ai →

Local Deployment

Run Fibo-Edit on your own hardware using Hugging Face weights and Diffusers pipeline.

  • Full data privacy
  • No per-image cost
  • Requires 24GB+ VRAM
Hugging Face →

Enterprise / Hybrid

Private deployment on your cloud (AWS, Azure, GCP) with Bria enterprise support.

  • VPC deployment
  • SLA guarantees
  • Legal indemnification
Contact Bria →

Performance & Cost Optimization

Tips for optimizing Fibo-Edit inference speed and managing costs at scale.

Inference Steps vs Quality

20
Fast, lower quality
50
Balanced (default)
100
High quality, slower

Cost Estimation (fal.ai)

Volume Cost
1,000 images $40
10,000 images $400
100,000 images $4,000
1,000,000 images Contact for volume pricing

Fibo-Edit vs Alternatives

How Fibo-Edit compares to Photoshop Generative Fill, Adobe Firefly, and Stable Diffusion inpainting.

Feature Fibo-Edit Photoshop Gen Fill Adobe Firefly SD Inpaint
Edit Control JSON + Mask Text prompt Text prompt Text + Mask
Deterministic Output Yes No No No
Licensed Training Data 100% Yes Yes Mixed
API Access REST API No Limited Various
Open Weights Hugging Face No No Yes
ComfyUI Support Official Nodes No No Yes
Commercial Indemnity Via Bria Yes Yes No

Why "Prompt Drift" Happens (And How Fibo-Edit Avoids It)

Traditional AI image editors produce unpredictable results. Fibo-Edit's structured approach eliminates this.

The Problem with Text Prompts

Traditional AI editors interpret text prompts probabilistically. The same prompt can produce wildly different results each time—we call this "prompt drift" or the "prompt lottery."

Traditional Approach

"Make it more blue" → Different shades, different areas affected, inconsistent results across runs.

Fibo-Edit Approach

{"prompt": "recolor to #1E40AF navy blue", "mask": "shirt_region.png"} → Same input = same output, every time.

Traditional vs Deterministic

3 runs, 3 different results

Traditional AI

3 runs, identical results

Fibo-Edit

Templates Library (Common Edit Presets)

Ready-to-use JSON templates for common editing tasks. Copy, customize, and deploy.

Background Swap

E-Commerce
{
  "prompt": "place product on white marble surface with soft shadows",
  "guidance_scale": 6
}

Replace plain backgrounds with lifestyle contexts for product photography.

Studio Lighting

Photography
{
  "prompt": "add warm studio lighting from upper left, soft shadows",
  "guidance_scale": 5
}

Add professional studio lighting to flat or poorly-lit product shots.

Color Variant

E-Commerce
{
  "prompt": "recolor to deep navy blue, preserve texture and reflections",
  "mask_url": "[product_region_mask]"
}

Generate SKU color variants from a single product photo.

Material Transform

Design
{
  "prompt": "transform to brushed metallic silver finish",
  "mask_url": "[surface_mask]"
}

Convert surfaces between materials—matte to glossy, plastic to metal, etc.

Troubleshooting Common Errors

Solutions for the most common Fibo-Edit issues. Search or browse by error type.

Error: "Mask dimensions do not match image dimensions"

Solution: Resize your mask to exactly match your source image resolution. If your image is 1024x1024, your mask must also be 1024x1024.

Cause: Mask is all black (no edit region defined) or prompt is too vague.

Solution: Ensure white regions in your mask cover the areas you want to edit. Make your prompt more specific: "recolor the shirt to red" instead of "change color".

Error: "Unable to fetch image from URL"

Solution: Ensure your image URL is publicly accessible (not behind authentication). Use direct image URLs, not webpage URLs. Test by opening the URL directly in a browser.

Error: "CUDA out of memory"

Solution: Fibo-Edit's 8B model requires 24GB+ VRAM for full inference. Enable CPU offloading in your inference script, or reduce image resolution. Alternatively, use the cloud API.

Cause: Hard mask edges without feathering.

Solution: Add 2-5 pixels of Gaussian blur or feathering to your mask edges in Photoshop, GIMP, or your image editor of choice.

Changelog / Release Notes

Track Fibo-Edit updates, new features, and improvements.

January 20, 2026

ComfyUI Partner Nodes Release

Official Bria nodes for ComfyUI now available. Includes BRIA Image Edit, Outpainting, and Background Remove nodes.

January 16, 2026

Fibo-Edit Public Launch

Initial release of Fibo-Edit model. 8B parameter DiT architecture with JSON-native structured editing. Open weights on Hugging Face, API on fal.ai.

Coming Soon

Replicate Integration

Fibo-Edit deployment on Replicate platform for additional API options.

Resources & Documentation

Official documentation, guides, and community resources for Fibo-Edit.

Frequently Asked Questions

Common questions about Fibo-Edit licensing, usage, and capabilities.

Fibo-Edit offers open weights under CC BY-NC 4.0 for non-commercial use. For commercial usage, you need a license from Bria AI. API access via fal.ai costs $0.04 per image.

Yes. Fibo-Edit is trained on 100% licensed data, making outputs commercial-safe. For commercial API usage with full legal indemnification, obtain a license from Bria AI.

Fibo-Edit uses structured JSON parameters instead of probabilistic text prompts. This means deterministic outputs—same input always produces the same output. Combined with precise mask control, you get production-ready results without "prompt drift."

Yes. Official Bria ComfyUI Partner Nodes were released January 2026. Install via ComfyUI Manager or from the Bria GitHub repository. You can also test instantly on Comfy Cloud.

Fibo-Edit's 8B parameter model requires 24GB+ VRAM for full inference. CPU offloading is supported for systems with less VRAM but will be slower. Recommended settings: 50 inference steps, guidance scale 5.

Fibo-Edit supports PNG, JPG, and WebP formats. Maximum resolution is 4096px on the longest side. For best results, use square images (1024x1024) or common aspect ratios.

Images processed via fal.ai are not stored permanently—they're deleted after processing. For enterprise users with strict data requirements, Bria offers private VPC deployment options.

Stay Updated

Get weekly Fibo-Edit tutorials, JSON templates, and workflow tips delivered to your inbox.

No spam. Unsubscribe anytime. We respect your privacy.

Community

Join the Fibo-Edit community on GitHub, Discord, and X to share workflows and get help.

Tutorials & Guides

Learn Fibo-Edit with in-depth tutorials, comparisons, and use-case guides.

Site Navigation

Quick links to all Fibo-Edit resources and documentation.