Spiral gives your agent every tool with one account. Browse the tools →

falImageAvailable now

Grok Imagine Image · Edit Image

xai/grok-imagine-image/edit

Generate and edit images from text with Grok Imagine Image · Edit Image from fal through one Spiral API key. It runs in the background and returns images. Pay as you go, with no subscription.

Pricing

resolution: 1k (default) $0.0286, 2k $0.0286 per image. Billed on num_images, default 1.

Limits

Runs
In the background
Returns
image
Longest queue wait
1 hour
Run deadline
30 minutes
Longest run, end to end
225 minutes
Largest inline input
1 MB
Largest input file
2 GB
Largest output
5 GB

Input

FieldKindDefaultDescription
prompt requiredtext—

Text description of the desired image.

image_urlsURLs or files—

List of URLs of the images to edit. A maximum of 3 images are supported.

image_passthroughtrue or falsefalse

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.

num_imagesnumber (whole)
1 to 4
1

Number of images to generate.

aspect_ratioone of
auto, 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

Aspect ratio of the edited image. When set to auto (the default), the output preserves the aspect ratio of the first input image.

resolutionone of
1k, 2k
1k

Resolution of the generated image. 1k for standard resolution, 2k for high resolution.

output_formatone of
jpeg, png, webp
jpeg

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

Frequently asked questions

How much does Grok Imagine Image · Edit Image cost?

`resolution`: 1k (default) $0.0286, 2k $0.0286 per image. Billed on `num_images`, default 1. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use Grok Imagine Image · Edit Image through an API?

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "xai/grok-imagine-image/edit"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

Do I need an account with fal to use Grok Imagine Image · Edit Image?

No. Spiral runs it on its own fal account and charges your Spiral balance.

Can my AI agent use Grok Imagine Image · Edit Image?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.