falImage to imageComing soon

fal-ai/image-apps-v2/outpaint

Name: fal-ai/image-apps-v2/outpaint
Brand: fal

fal-ai/image-apps-v2/outpaint is an image to image tool from fal that runs in the background and returns images. Coming soon: listed with its price, not yet open to runs.

This tool is listed but not yet available to run.

Price pending

Pricing

Price pending.

Limits

Runs: In the background
Returns: image
Longest queue wait: 3600s
Run deadline: 1800s
Largest inline input: 1024 KB
Largest input file: 500 MB
Largest output: 4768 MB
Outputs per run: 16

Input

Field	Kind	Default	Description
`image_url` required	URL or file	—	Image URL to outpaint
`expand_left`	number (whole) 0 to 700	0	Number of pixels to add as black margin on the left side (0-700).
`expand_right`	number (whole) 0 to 700	0	Number of pixels to add as black margin on the right side (0-700).
`expand_top`	number (whole) 0 to 700	0	Number of pixels to add as black margin on the top side (0-700).
`expand_bottom`	number (whole) 0 to 700	0	Number of pixels to add as black margin on the bottom side (0-700).
`zoom_out_percentage`	number 0 to 90	20	Percentage to zoom out the image. If set, the image will be scaled down by this percentage and black margins will be added to maintain original size. Example: 50 means the image will be 50% of original size with black margins filling the rest.
`prompt`	text		Optional prompt to guide the outpainting. If provided, it will be appended to the base outpaint instruction. Example: 'with a beautiful sunset in the background'
`seed`	number (whole)	—	The same seed and the same prompt given to the same version of the model will output the same image every time.
`num_images`	number (whole) 1 to 4	1	Number of images to generate.
`output_format`	one of png, jpeg, jpg, webp	png	The format of the output image.

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": "fal-ai/image-apps-v2/outpaint",
    "input": {
      "image_url": "https://v3.fal.media/files/koala/oei_-iPIYFnhdB8SxojND_qwen-edit-res.png"
    }
  }'