falText to imageAvailable now
falxai/grok-imagine-image/v2.0/text-to-image
xai/grok-imagine-image/v2.0/text-to-image is a text to image tool from fal that runs in the background and returns images. Pay as you go from $0.013 per fal unit ($0.01), with one API key.
Try itfrom $0.013 / fal unit ($0.01)
Pricing
quality / resolution: low / 1k (default) $0.052, low / 1.5k $0.065, low / 2k $0.078, otherwise / 1k (default) $0.078, otherwise / 1.5k $0.091, otherwise / 2k $0.104 per 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. |
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. `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…"
}
}'