Grok Imagine Image 2.0 · Text to Image
xai/grok-imagine-image/v2.0/text-to-imageGenerate 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
| Field | Kind | Default | Description |
|---|---|---|---|
prompt required | text | — | Text description of the desired image. |
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 | 1:1 | Aspect ratio of the generated image. Use auto to let the provider choose. |
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 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/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.