Fibo 2.0 Edit
bria/fibo-2/editEdit and enhance images with Fibo 2.0 Edit from fal through one Spiral API key. It runs in the background and returns images. Pay as you go, with no subscription.
Pricing
$0.052 per image.
Limits
- Runs
- In the background
- Returns
- image
- Longest queue wait
- 1 hour
- Run deadline
- 30 minutes
- Longest run, end to end
- 225 minutes
- Largest inline input
- 1 MB
- Largest input file
- 2 GB
- Largest output
- 5 GB
Input
| Field | Kind | Default | Description |
|---|---|---|---|
image_urls required | URLs or files | — | 1-4 images to edit (files or URLs). The instruction refers to them as <image_1>, <image_2> and so on, in the order they are sent. |
instruction | text | — | The edit, in free-form text. It is expanded into a VGL, which is returned. With 'vgl', the change to make to it. 'prompt' is accepted as an alias. |
aspect_ratio | one of 1:1, 1:2, 1:3, 1:4, 1:5, 2:1, 2:3, 3:1, 3:2, 3:4, 4:1, 4:3, 4:5, 5:1, 5:4, 9:16, 9:21, 10:16, 16:9, 16:10, 21:9 | — | Output aspect ratio, at about one megapixel. Left unset, the output keeps the ratio of the first image. A single image always keeps its own ratio. |
seed | number (whole) 0 to 2147483647 | 5555 | Random seed for reproducibility, 0 to 2147483647. |
mask_url | URL or file | — | Mask (file or URL) marking the region to regenerate: white where the model should edit, black elsewhere. Single-image requests only, at that image's size. A masked edit comes back at the image's own size, with its own pixels outside the mask. |
vgl | JSON | — | A VGL (Visual Generation Language) document. Alone, it is the edit as-is and must carry its 'edit_instruction'. With 'instruction', it is the first image's VGL, the baseline the edit is written from. Accepts what a previous request returned. |
Same request in code
curl https://api.spiral.ai/v1/runs \
-H "Authorization: Bearer $SPIRAL_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"provider": "fal",
"model": "bria/fibo-2/edit",
"input": {
"image_urls": [
"<image_urls>"
]
}
}'Frequently asked questions
How much does Fibo 2.0 Edit cost?
$0.052 per image. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.
How do I use Fibo 2.0 Edit through an API?
Send `POST /v1/runs` with `"provider": "fal"`, `"model": "bria/fibo-2/edit"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.
Do I need an account with fal to use Fibo 2.0 Edit?
No. Spiral runs it on its own fal account and charges your Spiral balance.
Can my AI agent use Fibo 2.0 Edit?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.