Black Forest Labs · fal.ai · Outpaint
FLUX.2 [pro]
FLUX.2 [pro] (Black Forest Labs), outpaint, served by fal.ai. The OpenAPI schema for the fal-ai/flux-2-pro/outpaint queue. Price: $0.03 for the first megapixel of output plus $0.015 per extra megapixel of input and output, rounded up to the megapixel, metered by fal after the call (x-fal-billable-units) and billed at that reading; the reservation is the bound you declare and the difference is refunded.
From $0.015 / unitfal.aiImagefal/flux-2-pro-outpaintListed
Activation pending; your agent will see it as unavailable until then.
Use this tool with your agent
Use my connected Agentik MCP server. I want to use the tool fal/flux-2-pro-outpaint (FLUX.2 [pro] (Black Forest Labs), outpaint). Call inspect_tool with {"tool_id": "fal/flux-2-pro-outpaint"} first and tell me the price before anything runs. Ask me for the inputs it needs; never invent values, IDs or file URLs. When I confirm, call run_tool with tool_id "fal/flux-2-pro-outpaint" and my inputs, follow it with get_run if it is still running, and give me the result and the price Agentik reports. If the tool is unavailable, say so and use discover_tools to propose an alternative.Show the prompt
Paste it into Claude, ChatGPT or Codex: your agent takes it from there, and shows the price before it runs.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
enable_safety_checker | boolean | No | Whether to enable the safety checker. Disabling it requires account authorization; unauthorized requests are always checked. |
mode | string | No | Quality/speed trade-off for outpainting. `high` (default) delivers the highest-fidelity results; `fast` is significantly faster and extends most scenes well but may produce lower fidelity. Options: high, fast. |
expand_bottom | integer | No | Pixels to expand at the bottom of the image. |
expand_top | integer | No | Pixels to expand at the top of the image. |
expand_right | integer | No | Pixels to expand on the right of the image. |
output_format | string | No | The format of the generated image. Options: jpeg, png. |
image_url | string | Yes | The image URL to expand using outpainting. |
expand_left | integer | No | Pixels to expand on the left of the image. |
auto_crop | boolean | No | Whether to automatically crop the reference image when the expanded canvas does not fully contain it. |
max_megapixels | number | No | Upper bound of the megapixels of input and output together, in megapixels (default 6, max 40). The reservation is this bound at the unit price; after the call the megapixels fal meters are billed and the rest is refunded. Declare at least the real amount: a larger input is still processed but is never billed above the reservation. |
How your agent calls it
First inspect_tool for the current schema and price, then run_tool with the published example after confirming your inputs:
{
"tool_id": "fal/flux-2-pro-outpaint",
"input": {
"image_url": "https://storage.googleapis.com/falserverless/example_inputs/flux2/max.jpg",
"expand_left": 256,
"expand_right": 256,
"mode": "fast",
"max_megapixels": 6
}
}Price and billing
- Price
- From $0.015 / unit
- Model
- Per unit
- Detail
- The provider’s price, with no markup. Billed for measured usage.
- The provider’s price, 0% markup.
- One prepaid balance for every provider; your agent sees the price before it runs.
- Pay for measured usage; unused reservations are released.