How to Use Grok Imagine Image in Codex
Grok Imagine Image turns written briefs into illustrations, editorial images, and game concepts. Unlike Grok Imagine Image Edit, it starts from text alone, making it useful when you have an idea but no source artwork.
Prompts to try with Grok Imagine Image in Codex
Copy an example into Codex, or ask in your own words.
Read the homepage copy and use Grok Imagine Image to create a 16:9 illustration at 2K for its main section. Show a small greenhouse on a city rooftop, viewed at eye level in soft morning light, with the left third kept clear for the heading.
Use Grok Imagine Image to create a 1K square illustration for this project's empty search state. Show a librarian examining an empty shelf, with simple shapes, a clear silhouette, and no lettering. Save the image beside the other illustration assets.
Read the game's environment brief and use Grok Imagine Image to create a 16:9 concept at 2K of its coastal repair workshop. Show the workbench in the foreground, an open harbor doorway behind it, and afternoon light entering from the right.
Generate a product photo with Grok Imagine Image: a matte black water bottle on wet slate, soft morning light, 1:1. Tell me the price first. Save the result in ./assets.
Make four logo concepts for a coffee brand called "Northline" with Grok Imagine Image.
How to set up Grok Imagine Image in Codex
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
codex mcp add spiral --url https://api.spiral.ai/mcp
- Sign in
Codex opens the browser: sign in to Spiral and click Authorize. No API key. codex mcp list then shows Spiral.
codex mcp login spiral
Use the Spiral skill
- Send Codex this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Grok Imagine Image
One request; the result comes back by polling or a webhook.
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", "input": { "prompt": "Abstract human silhouette, golden particles ready to burst outward representing joy, data visualization style, emotional expression through particles, artistic…" } }'
Then paste one of the prompts above: Codex finds Grok Imagine Image on Spiral, shows the price and runs it.
Grok Imagine Image providers and prices
Spiral runs Grok Imagine Image through fal. Open a card for today's price, with every fee included.
resolution: 1k (default) $0.026, 2k $0.026 per image. Billed on num_images, default 1.
Settings you can ask for
Grok Imagine Image works from your prompt. Ask Codex for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Image passthrough | on or off | off | 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. |
| Number of images | 1 to 4 | 1 | Number of images to generate. |
| Aspect ratio | 2:1, 20:9, 19.5:9, 16:9, 4:3, 3:2, 1:1, 2:3 and 5 more | 1:1 | Aspect ratio of the generated image. |
| Resolution | 1k or 2k | 1k | Resolution of the generated image. |
| Output format | jpeg, png, or webp | jpeg | The format of the generated image. |
Every API field of Grok Imagine Image · Text to Image is on its tool page: open its card above.
What can you do with Grok Imagine Image in Codex?
Produce illustrations and concept art for the project without leaving the coding workflow. Have the agent turn the project's content into a concrete visual brief and review the image in its intended layout.
Website illustrations
Develop an illustration for a feature page, with a clear focal subject and space reserved for the heading. Create new artwork from a brief or revise an existing illustration.
Editorial artwork
Illustrate an article's central idea with a single readable scene. Specify the setting, viewpoint, and lighting, or adapt existing artwork to the article's subject.
Game environment concepts
Explore a harbor, workshop, or research station before committing to production art. Use a written scene brief or develop an existing environment concept.
Social campaign artwork
Develop still illustrations around a campaign theme. Define the subject and composition, and leave room for final campaign copy to be added during design.
Character concepts from a brief
Turn a character description into concept art without a reference image. Describe clothing, posture, held objects, and the setting in complete sentences.
Early visual direction
Create initial artwork for an idea that exists only in writing. Compare different compositions or lighting directions before selecting a look.
More on Grok Imagine Image and Codex
Overview
Grok Imagine Image in other agents
Questions about Grok Imagine Image in Codex
Can Codex use Grok Imagine Image?
Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Grok Imagine Image like any built-in tool.
How much does Grok Imagine Image cost in Codex?
`resolution`: 1k (default) $0.026, 2k $0.026 per image. Billed on `num_images`, default 1. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Codex plan is separate.
Do I need a fal account to use Grok Imagine Image in Codex?
No. Spiral runs Grok Imagine Image on its own fal account. You sign in to Spiral once and never paste a key.
How long does it take to set up Grok Imagine Image in Codex?
About two minutes: add the hosted server, then sign in.
Does Codex wait while Grok Imagine Image runs?
Grok Imagine Image runs in the background. Codex starts the run, checks on it and gives you the image when it's ready.
What is Grok Imagine Image useful for?
Try it for illustrations, editorial artwork, and game concepts. Layer's comparison describes its output as cleaner, flatter, and more cartoon-like than Grok Imagine Image 2.0, making stylized briefs a useful starting point.
What is the largest output resolution?
Grok Imagine Image supports output up to 2K. Use 1K to explore a composition, then request 2K for the selected direction.
How should I write a Grok Imagine Image prompt?
Describe the subject, setting, composition, lighting, and visual finish in full sentences. For example, specify an overhead view and soft light from the left instead of asking for a good-looking image.
What needs extra review?
Review photorealistic details and any lettering before using the result. Fal positions Grok Imagine Image (Quality) as offering higher fidelity for photorealism and text rendering, so allow room for revisions on those tasks.
Does Grok Imagine Image make video?
No. Grok Imagine Image produces still images; write the brief around one composition rather than a sequence of actions.
Start using Grok Imagine Image in Codex
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Codex:
set up https://spiral.ai/SKILL.md


