Skip to content

Fibo 2.0 Edit

Integrate

Model id bria/fibo-2/edit
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/bria/fibo-2/edit?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

This request: $0.04 40 API credits Run it on this page

Get API key
Bria AI Image Editing #image-editing#instruction-based-image-editing#reference-images#e-commerce

Instruction-based editor taking 1 to 4 images, with optional mask for single-image regional edits

Bria AI · Image

Your first result goes here

Build a request below and run it with your API key. Outputs are copied to our storage, kept forever or 7 days for free.

Build a request

Controls are generated from the model schema. The code and the price update as you change them.

•required image_urls
Drop a file, or · up to 4

Editing inputs indexed by submission order as <image_1>, <image_2>, and so on for use in the instruction. Supply 1–4 images as files or URLs.

Aspect ratio setting for an output of roughly one megapixel; a single input image retains its ratio regardless of this setting. With multiple inputs, omitting the setting uses the first image's ratio.

Advanced instruction · mask · seed · vgl

Editing directions that modify 'vgl' when supplied alongside it. Otherwise, the free-form request is expanded into a VGL document and included in the response.

mask_url
Drop a file, or

Editing mask for requests containing a single image, supplied as a file or URL with dimensions matching that image. White marks regeneration areas; black marks everything else. The result uses the input dimensions and retains its pixels outside the mask.

default 5555

Seed controlling randomness for reproducible results, ranging from 0 through 2147483647.

VGL (Visual Generation Language) document that can be reused from an earlier response. Alongside 'instruction', it represents the first image and provides the baseline for editing; without 'instruction', it specifies the edit unchanged and must contain 'edit_instruction'.

POST /run/bria/fibo-2/edit?wait=20 quote → $0.04
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/bria/fibo-2/edit?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Run this request

Your key stays in this browser: it is sent only to the Doitong API and saved (localStorage) only if you tick Remember. Get an API key

About Fibo 2.0 Edit

Edits one to four images given in `image_urls`, with the `instruction` referring to them as <image_1>, <image_2> and so on. Useful for background swaps and product restaging. A `mask_url` limits the edit to a region on single-image requests. `aspect_ratio` offers 16 listed values, and a structured `vgl` document can be passed or reused.

Parameters

Send either the canonical name or the native name, not both. Canonical names

NameType DefaultAllowed Description
image_urlsrequired images
Typeurl[] · image
≤ 4 items
Editing inputs indexed by submission order as <image_1>, <image_2>, and so on for use in the instruction. Supply 1–4 images as files or URLs.
instructionoptional
Typestring | null
Editing directions that modify 'vgl' when supplied alongside it. Otherwise, the free-form request is expanded into a VGL document and included in the response.
aspect_ratiooptional
Typeenum
1:11:21:31:41:52:12:33:13:23:44:14:34:55:15:49:16
+5 more9:2110:1616:916:1021:9
Aspect ratio setting for an output of roughly one megapixel; a single input image retains its ratio regardless of this setting. With multiple inputs, omitting the setting uses the first image's ratio.
seedoptional
Typeinteger
Default5555
0 – 2,147,483,647
Seed controlling randomness for reproducible results, ranging from 0 through 2147483647.
mask_urloptional mask
Typeurl · image
Editing mask for requests containing a single image, supplied as a file or URL with dimensions matching that image. White marks regeneration areas; black marks everything else. The result uses the input dimensions and retains its pixels outside the mask.
vgloptional
Typeobject
VGL (Visual Generation Language) document that can be reused from an earlier response. Alongside 'instruction', it represents the first image and provides the baseline for editing; without 'instruction', it specifies the edit unchanged and must contain 'edit_instruction'.
vgl.short_descriptionoptional
Typestring | null
Brief description of the intended output image.
vgl.objectsoptional
Typeobject[]
Default[]
Specify the generated image's contents as a list, recording each object's attributes and its relationships with the other depicted objects.
vgl.objects[].descriptionoptional
Typestring | null
Description of the intended output object.
vgl.objects[].locationoptional
Typestring | null
Object position within the image.
vgl.objects[].relationshiprequired
Typestring
Object's relationship to the image's other objects.
vgl.objects[].relative_sizeoptional
Typestring | null
Object size relative to the image.
vgl.objects[].shape_and_coloroptional
Typestring | null
Object's shape and color.
vgl.objects[].textureoptional
Typestring | null
Object's texture.
vgl.objects[].appearance_detailsoptional
Typestring | null
Details describing the object's appearance.
vgl.objects[].number_of_objectsoptional
Typeinteger | null
Count of objects within the image.
vgl.objects[].poseoptional
Typestring | null
Pose of the depicted object.
vgl.objects[].expressionoptional
Typestring | null
Expression shown by the depicted object.
vgl.objects[].clothingoptional
Typestring | null
Clothing worn by the depicted object.
vgl.objects[].actionoptional
Typestring | null
Action performed by the depicted object.
vgl.objects[].genderoptional
Typestring | null
Gender of the depicted object.
vgl.objects[].skin_tone_and_textureoptional
Typestring | null
Skin texture and tone of the depicted object.
vgl.objects[].orientationoptional
Typestring | null
Orientation of the depicted object.
vgl.background_settingoptional
Typestring | null
Background setting for the generated image.
vgl.lightingoptional
Typeobject
Lighting for the generated image.
vgl.lighting.conditionsoptional
Typestring | null
Lighting conditions for the generated image.
vgl.lighting.directionoptional
Typestring | null
Lighting direction for the generated image.
vgl.lighting.shadowsoptional
Typestring | null
Shadows to depict in the generated image.
vgl.aestheticsoptional
Typeobject
Aesthetic qualities for the generated image.
vgl.aesthetics.compositionoptional
Typestring | null
Composition for the generated image.
vgl.aesthetics.color_schemeoptional
Typestring | null
Color palette for the generated image.
vgl.aesthetics.mood_atmosphereoptional
Typestring | null
Mood and atmosphere for the generated image.
vgl.photographic_characteristicsoptional
Typeobject
Photographic properties for the generated image.
vgl.photographic_characteristics.depth_of_fieldoptional
Typestring | null
Depth of field for the generated image.
vgl.photographic_characteristics.focusoptional
Typestring | null
Focus for the generated image.
vgl.photographic_characteristics.camera_angleoptional
Typestring | null
Camera angle for the generated image.
vgl.photographic_characteristics.lens_focal_lengthoptional
Typestring | null
Lens setting for the generated image, expressed as a focal length.
vgl.style_mediumoptional
Typestring | null
Stylistic medium for the generated image.
vgl.text_renderoptional
Typeobject[]
Default[]
List of text entries to include in the image.
vgl.text_render[].textrequired
Typestring
Text for rendering, also presented visually to fibo-2 as an image to help reproduce the supplied wording exactly.
vgl.text_render[].locationoptional
Typestring | null
Text placement within the image.
vgl.text_render[].sizeoptional
Typestring | null
Text size within the image.
vgl.text_render[].coloroptional
Typestring | null
Color used for the text.
vgl.text_render[].fontoptional
Typestring | null
Font style for the text.
vgl.text_render[].appearance_detailsoptional
Typestring | null
Additional noteworthy details about the text's appearance.
vgl.contextoptional
Typestring | null
Context for the generated image.
vgl.artistic_styleoptional
Typestring | null
Artistic style for the generated image.
vgl.edit_instructionoptional
Typestring | null
Instruction describing how to edit the image.
required Canonical name, also accepted

File parameters take a public https:// URL, a data: URI up to 10 MB, or the file_url of an upload. Files

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "bria/fibo-2/edit",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 40,
    "usd": "0.04",
    "charged": 40,
    "refunded": 0
  },
  "input": {
    "image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  },
  "output": {
    "image": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768
    },
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200,
        "width": 1024,
        "height": 768
      }
    ],
    "vgl": {}
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Your files, your choiceEvery outputs[].url is a copy on our storage: kept forever (paid per GB-month) or 7 days for free, by your account setting or ?storage=.
Same shape on every modeltype, url, content_type, width, height and duration, for images, video and audio alike. output is the model’s own result object.
Fields of output
image
object {url, content_type, file_name, file_size, width, height}Image resulting from the edit.
images
array of object {url, content_type, file_name, file_size, width, height}Image list matching the format returned by other FIBO apps; its sole entry is the same image.
vgl
objectVGL used for the edit, with its `edit_instruction` included.

More models: Image Editing

For AI agents: this page as Markdown is at https://doitong.com/developers/models/bria/fibo-2/edit.md. All models and guides: https://doitong.com/developers/llms.txt