Outpaint or extend an image
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.
Authorizations
Body
Public contract for /v1/flux-tools/outpainting-v1.
Base64-encoded input (reference) image or HTTP(S) image URL.
Target output width.
x >= 64Target output height.
x >= 64Opaque identifier for the end user supplied by the calling platform.
1 - 256If True, crop the input image to the canvas bounds when it extends beyond the edges. If False, an error is raised instead.
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.
0 <= x <= 7jpeg, png, webp 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.
Left offset (px) of the reference image's top-left corner on the output canvas. Negative values are allowed. None = center horizontally.
Top offset (px) of the reference image's top-left corner on the output canvas. Negative values are allowed. None = center vertically.
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'.
high, fast 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.

