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

falImageAvailable nowReleased 2026-08-06

Grok Imagine Image 2.0 · Text to Image

xai/grok-imagine-image/v2.0/text-to-image

Generate images from text with Grok Imagine Image 2.0 · Text to Image from fal through one Spiral API key. Generates up to 10 images from a text prompt with xAI's Grok Imagine Image 2.0, at 1k, 1.5k or 2k in many aspect ratios. It runs in the background and returns images. Pay as you go, with no subscription.

Pricing

$0.052 per image at 1K, low quality ($0.065 at 1.5K, $0.078 at 2K); other qualities $0.078 at 1K ($0.091 at 1.5K, $0.104 at 2K).

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.

num_imagesnumber (whole)
1 to 10
1

Number of images to generate.

aspect_ratioone 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
1:1

Aspect ratio of the generated image. Use auto to let the provider choose.

resolutionone of
1k, 1.5k, 2k
1k

Resolution of the generated image: 1k, 1.5k, or 2k.

output_formatone of
jpeg, png, webp
jpeg

The format of the generated image.

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.

qualityone of
low, medium, auto
medium

Quality level of the generated image. auto lets xAI choose; it currently uses low for generation.

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/text-to-image",
    "input": {
      "prompt": "Abstract human silhouette, golden particles ready to burst outward representing joy, data visualization style, emotional expression through particles, artistic…"
    }
  }'

Frequently asked questions

How much does Grok Imagine Image 2.0 · Text to Image cost?

$0.052 per image at 1K, low quality ($0.065 at 1.5K, $0.078 at 2K); other qualities $0.078 at 1K ($0.091 at 1.5K, $0.104 at 2K). 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 2.0 · Text to Image through an API?

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "xai/grok-imagine-image/v2.0/text-to-image"` 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 2.0 · Text to Image?

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

Can my AI agent use Grok Imagine Image 2.0 · Text to Image?

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