# Bria Expand (FIBO-Edit-1.5) API

> Outpainting-tool die een afbeelding uitbreidt naar een nieuwe beeldverhouding of aangepast canvas onder 25 megapixels

Breidt een afbeelding buiten de randen uit. Kies een van negen `aspect_ratio`-waarden of definieer `canvas_size` als [width, height] met een oppervlakte onder 25 megapixels, plus `original_image_size` en `original_image_location`. Een optionele `prompt` beschrijft het nieuwe gebied. `retain_original_quality` en `preserve_alpha` zijn standaard ingeschakeld en `return_model_output` is bedoeld voor diagnostiek.

- Model id: `bria/fibo-edit-1.5/expand`
- Made by: Bria AI
- Category: Image Editing
- Output: image
- Price: $0.04 / image (cheapest run $0.04 (40 API credits))
- Run: `POST https://api.doitong.com/v1/run/bria/fibo-edit-1.5/expand`
- Quote: `POST https://api.doitong.com/v1/quote/bria/fibo-edit-1.5/expand`
- Docs page: https://doitong.com/nl/developers/models/bria/fibo-edit-1.5/expand

## Pricing

Price: **$0.04 / image**. Billed per generated image.

The full example input below costs $0.04 = 40 API credits (1 image × 40 API credits).

Prices are the upstream price in USD, paid from the API balance in API credits (1000 API credits = 1 USD). `POST https://api.doitong.com/v1/quote/bria/fibo-edit-1.5/expand` with the same JSON body returns the exact price for that input; the quote is exactly what a run charges. Invalid input is never charged and failed or canceled requests are refunded automatically.

## Input parameters

Send either the canonical name or the native field name (not both). Canonical names are the same across models.

| Parameter | Canonical name | Type | Required | Default | Allowed values / range | Description |
|---|---|---|---|---|---|---|
| `image_url` | `image` | string (image URL) | yes |  |  | Afbeelding voor uitbreiding, aangeleverd als bestand of URL. |
| `canvas_size` |  | array of integer \| null | no |  | 2 – 2 items | Afmetingen van de uitgebreide afbeelding in combinatie met 'original_image_location'. Geef [width, height] op voor het uiteindelijke canvas, met een gebied van minder dan 25 megapixels. |
| `aspect_ratio` |  | enum (string) \| null | no |  | `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9` | Instelling voor de uiteindelijke afbeeldingsverhouding die het origineel centreert en het omliggende canvas uitbreidt. Deze instelling heeft voorrang op zowel 'original_image_size' als 'original_image_location'. |
| `original_image_size` |  | array of integer \| null | no |  | 2 – 2 items | Doel-[width, height] voor de oorspronkelijke afbeelding binnen het canvas. 'aspect_ratio' overschrijft deze instelling; anders wordt de afbeelding vóór plaatsing naar deze afmetingen geschaald. |
| `original_image_location` |  | array of integer \| null | no |  | 2 – 2 items | Plaatsingscoördinaten [x, y] voor de linkerbovenhoek van de oorspronkelijke afbeelding, genegeerd wanneer 'aspect_ratio' wordt opgegeven. Plaatsing buiten de canvasgrenzen is toegestaan en snijdt het origineel bij. |
| `prompt` |  | string \| null | no |  |  | Optionele beschrijving van de inhoud voor het toegevoegde gebied. Voor een eenvoudige canvasaanpassing is meestal geen beschrijving nodig: weglaten vraagt het model alleen de bestaande afbeelding uit te breiden. |
| `seed` |  | integer \| null | no |  | 0 – 2,147,483,647 | Seed voor willekeurige generatie, altijd opgenomen in de respons, ongeacht of deze hier is aangeleverd of bij weglating willekeurig is gekozen. Een waarde uit een eerdere respons kan het resultaat reproduceren. |
| `negative_prompt` |  | string \| null | no |  |  | Compatibiliteitscontrole voor requests die zijn geschreven voor de SDXL-expansie-API-route: door deze niet-ondersteunde invoer aan te leveren wordt expliciete afwijzing geactiveerd, zodat de waarde niet stilzwijgend verloren gaat. Gebruik 'prompt' in plaats daarvan. |
| `retain_original_quality` |  | boolean | no | `true` |  | Schakel dit in om de door het masker beschermde oorspronkelijke pixels op volledige resolutie te behouden zonder hersampling. Het model genereert op ongeveer één megapixel en schaalt daarna op voor grotere canvassen. Uitschakelen maakt het resultaat overal zacht, waardoor een naad tegen een getextureerde achtergrond minder zichtbaar kan worden. |
| `preserve_alpha` |  | boolean | no | `true` |  | Behoudt transparantie van de invoer door het oorspronkelijke alfakanaal indien nodig via randreplicatie uit te breiden voor een uitsnede. Omdat generatie in RGB plaatsvindt, produceert het model geen alfa. Schakel dit uit om afgevlakte RGB-uitvoer te ontvangen. |
| `return_model_output` |  | boolean | no | `false` |  | Retourneer een extra diagnostisch frame om modelfouten van compositiefouten te onderscheiden, zonder de uiteindelijke afbeelding te wijzigen. Het toont het resultaat van het model voordat het origineel opnieuw wordt ingevoegd en naden worden gemengd; een grensdefect dat al in dit frame zichtbaar is, is een generatiefout en geen fout in de nabewerking. |

File parameters (`image`) take a public `https://` URL, a `data:` URI up to 10 MB, or the `file_url` of an upload from `POST /files`.

## Example input

Required parameters only:

```json
{
  "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
}
```

A fuller example:

```json
{
  "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
}
```

## Run it

Set `DOITONG_API_KEY` to a key from https://doitong.com/developers/dashboard#keys. `?wait=20` returns the finished request in the same call when it is ready within 20 seconds; otherwise poll `GET /requests/{id}` (it also accepts `?wait=`), or pass `webhook_url`.

### curl

```bash
# 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-edit-1.5/expand?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "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"
```

### JavaScript

```javascript
const API = "https://api.doitong.com/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/bria/fibo-edit-1.5/expand?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");
```

### Python

```python
import os
import requests

API = "https://api.doitong.com/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/bria/fibo-edit-1.5/expand", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])
```

### MCP

The MCP server at `https://api.doitong.com/v1/mcp` exposes the tools `search_models`, `get_model`, `quote`, `run`, `get_request`, `cancel_request`, `list_requests`, `create_upload` and `get_account`. A `run` call for this model:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "run",
    "arguments": {
      "model_id": "bria/fibo-edit-1.5/expand",
      "input": {
        "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
      },
      "wait_seconds": 20
    }
  }
}
```

## Response

Every call returns a request object. `status` is one of `queued`, `running`, `succeeded`, `failed`, `canceled`. `outputs` lists the generated files with URLs on our storage (kept forever, or 7 days with `?storage=temporary`; `storage` says which); `output` is the model's own result object with the same URLs.

```json
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "bria/fibo-edit-1.5/expand",
  "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_url": "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
    },
    "seed": 42,
    "structured_instruction": {},
    "model_output": {
      "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
    }
  },
  "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"
  }
}
```

### Output fields (`output`)

| Field | Type | Description |
|---|---|---|
| `image` | object {url, content_type, file_name, file_size, width, height} | Afbeelding die uit de uitbreiding resulteert. |
| `seed` | integer | Seed die tijdens de generatie wordt toegepast en reproductie van het resultaat mogelijk maakt. |
| `structured_instruction` | object | Gestructureerde prompt die wordt gebruikt om het model te conditioneren. |
| `model_output` | object {url, content_type, file_name, file_size, width, height} \| null | Ongecomponeerd frame dat alleen wordt opgenomen wanneer 'return_model_output' is ingeschakeld. Het heeft de gevraagde canvasafmetingen en bevat de uitvoer van het model zonder geplakte of gemengde inhoud. |

## Related models

- [Bria Product Holding (FIBO-Edit-1.5)](https://doitong.com/developers/models/bria/fibo-edit-1.5/product-holding.md) (`bria/fibo-edit-1.5/product-holding`): $0.04 / image
- [Bria Virtual Try-On (FIBO-Edit-1.5)](https://doitong.com/developers/models/bria/fibo-edit-1.5/virtual-try-on.md) (`bria/fibo-edit-1.5/virtual-try-on`): $0.04 / image
- [Fibo Edit 1.5 Image Editing](https://doitong.com/developers/models/bria/fibo-edit-1.5/edit.md) (`bria/fibo-edit-1.5/edit`): $0.04 / image
- [FLUX.1 Kontext \[pro\]](https://doitong.com/developers/models/flux-pro/kontext.md) (`flux-pro/kontext`): $0.04 / image
- [GPT Image 2.5 Edit](https://doitong.com/developers/models/openai/gpt-image-2.5/flare/edit.md) (`openai/gpt-image-2.5/flare/edit`): from $0.12 / image
- [Nano Banana 2 Edit](https://doitong.com/developers/models/nano-banana-2/edit.md) (`nano-banana-2/edit`): from $0.06 / image
- [Nano Banana Pro Edit](https://doitong.com/developers/models/nano-banana-pro/edit.md) (`nano-banana-pro/edit`): from $0.15 / image
- [Qwen Image 3 Edit](https://doitong.com/developers/models/alibaba/qwen-image-3/edit.md) (`alibaba/qwen-image-3/edit`): from $0.04 / image

## Links

- HTML page: https://doitong.com/developers/models/bria/fibo-edit-1.5/expand
- All models and guides for AI agents: https://doitong.com/developers/llms.txt
- OpenAPI 3.1 with this model's typed request body: https://doitong.com/developers/openapi.json?model=bria/fibo-edit-1.5/expand
- Errors: https://doitong.com/developers/docs/errors
- Model details as JSON: https://api.doitong.com/v1/models/bria/fibo-edit-1.5/expand