BFbfl
Models

Outpaint or extend an image

Changed on

Submits an outpainting task. The input image is placed on a (width, height) canvas at the given offset, and the surrounding region is generated by a FLUX outpainting model.

post/v1/flux-tools/outpainting-v1

Request

Request body

userstring nullable

Opaque identifier for the end user supplied by the calling platform.

input_imagestring required

Base64-encoded input (reference) image or HTTP(S) image URL.

widthinteger required

Target output width.

heightinteger required

Target output height.

auto_cropboolean

If True, crop the input image to the canvas bounds when it extends beyond the edges. If False, an error is raised instead.

safety_toleranceinteger

Harm moderation tolerance from 0 to 7, with 0 the strictest. The route and organization determine the approved maximum and per-category ceilings. Unapproved levels return 422 with approved levels.

output_format'jpeg' | 'png' | 'webp'
promptstring nullable

Experimental: optional text guidance for the outpainted region. The model may not strictly follow this prompt; the visual content of the input image is the primary signal. Leave unset for default behavior.

reference_offset_xinteger nullable

Left offset (px) of the reference image's top-left corner on the output canvas. Negative values are allowed. None = center horizontally.

reference_offset_yinteger nullable

Top offset (px) of the reference image's top-left corner on the output canvas. Negative values are allowed. None = center vertically.

mode'high' | 'fast'

Quality/speed trade-off. 'high' (default): highest-fidelity results, recommended whenever fine detail, prompt adherence, or consistency with complex content in the source image matters; slower. 'fast': significantly faster and well-suited for naturally extending most scenes (landscapes, backgrounds, textures, products); may produce lower fidelity in the extended region than 'high'.

disable_pupboolean

Skip the image-aware prompt upsampler for lower latency. The prompt (or a default extension prompt) is sent directly to the generation model; quality in the extended region may be lower for scenes that benefit from semantic guidance. Applies to both modes.

Response

Successful Response

OR

Changes