falImage to imageAvailable now

xai/grok-imagine-image/v2.0/edit

xai/grok-imagine-image/v2.0/edit is an image to image tool from fal that runs in the background and returns images. Pay as you go from $0.013 per image, with one API key.

Try itfrom $0.013 / image

Pricing

quality low: 1k (default) $0.052, 1.5k $0.065, 2k $0.078 per output image. Other qualities: 1k $0.078, 1.5k $0.091, 2k $0.104. Each image in image_urls adds $0.013 per output image. Billed on num_images, default 1. The final charge comes from usage.

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
`prompt` required	text	—	Text description of the desired image.
`image_urls`	URLs or files	—	List of URLs of the images to edit. A maximum of 5 images are supported.
`num_images`	number (whole) 1 to 10	1	Number of images to generate.
`aspect_ratio`	one of 2:1, 20:9, 19.5:9, 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 9:19.5, 9:20, 1:2, auto, 21:9, 5:2	auto	Aspect ratio of the edited image. Standard auto uses the nearest supported ratio of the first reference. With image_passthrough=true, auto lets the provider choose a ratio, which may differ from the reference.
`resolution`	one of 1k, 1.5k, 2k	1k	Resolution of the generated image: 1k, 1.5k, or 2k.
`output_format`	one of jpeg, png, webp	jpeg	The format of the generated image.
`image_passthrough`	true or false	false	Send edit references and return provider images without resizing or re-encoding, preserving transparency and metadata. The returned native format may differ from output_format.
`quality`	one of low, medium, auto	medium	Quality level of the edited image. `auto` lets xAI choose; it currently uses `medium` for editing.

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": "xai/grok-imagine-image/v2.0/edit",
    "input": {
      "prompt": "Make this scene more realistic but still keep the game vibes"
    }
  }'