[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [Grok Imagine Image](https://spiral.ai/integrations/gemini-cli/grok-imagine-image)

# How to Use Grok Imagine Image in Gemini CLI

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.

|  |  |
| --- | --- |
| Model | Grok Imagine Image |
| Available through | fal |
| Category | Image |
| Price | `resolution`: 1k (default) $0.026, 2k $0.026 per image. Billed on `num_images`, default 1. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Grok Imagine Image in Gemini CLI

- 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 Gemini CLI

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the server**: Or add it to `~/.gemini/settings.json` yourself:

```bash
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `gemini` and run:

```text
/mcp auth spiral
```

3. **Check it**: In Gemini CLI, run `/mcp`. From your shell:

```bash
gemini mcp list
```

### Use the Spiral skill

1. **Send Gemini CLI this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Grok Imagine Image**: One request; the result comes back by polling or a webhook.

```bash
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: Gemini CLI finds Grok Imagine Image on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini-cli

## Grok Imagine Image tools and prices

- [Grok Imagine Image · Text to Image](https://spiral.ai/tools/fal/xai/grok-imagine-image) (fal): `resolution`: 1k (default) $0.026, 2k $0.026 per image. Billed on `num_images`, default 1.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| image_passthrough |  | 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. |
| num_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, 3:4, 9:16, 9:19.5, 9:20, 1:2 | 1:1 | Aspect ratio of the generated image. |
| resolution | 1k, 2k | 1k | Resolution of the generated image. `1k` for standard resolution, `2k` for high resolution. |
| output_format | jpeg, png, webp | jpeg | The format of the generated image. |

## What can you do with Grok Imagine Image in Gemini CLI?

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.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Gemini CLI guides](https://spiral.ai/integrations/gemini-cli)

## Grok Imagine Image in other agents

- [Amp](https://spiral.ai/integrations/amp/grok-imagine-image)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/grok-imagine-image)
- [Claude](https://spiral.ai/integrations/claude-desktop/grok-imagine-image)
- [Claude Code](https://spiral.ai/integrations/claude-code/grok-imagine-image)
- [Cline](https://spiral.ai/integrations/cline/grok-imagine-image)
- [Codex](https://spiral.ai/integrations/codex/grok-imagine-image)
- [Cursor](https://spiral.ai/integrations/cursor/grok-imagine-image)
- [Devin](https://spiral.ai/integrations/devin/grok-imagine-image)
- [dots](https://spiral.ai/integrations/dots/grok-imagine-image)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/grok-imagine-image)
- [Gemini](https://spiral.ai/integrations/gemini/grok-imagine-image)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/grok-imagine-image)
- [goose](https://spiral.ai/integrations/goose/grok-imagine-image)
- [Grok](https://spiral.ai/integrations/grok/grok-imagine-image)
- [Grok Build](https://spiral.ai/integrations/grok-build/grok-imagine-image)
- [Hermes](https://spiral.ai/integrations/hermes/grok-imagine-image)
- [Instinct](https://spiral.ai/integrations/instinct/grok-imagine-image)
- [Manus](https://spiral.ai/integrations/manus/grok-imagine-image)
- [Muse](https://spiral.ai/integrations/muse/grok-imagine-image)
- [Muse Code](https://spiral.ai/integrations/muse-code/grok-imagine-image)
- [n8n](https://spiral.ai/integrations/n8n/grok-imagine-image)
- [Notion](https://spiral.ai/integrations/notion/grok-imagine-image)
- [OpenClaw](https://spiral.ai/integrations/openclaw/grok-imagine-image)
- [opencode](https://spiral.ai/integrations/opencode/grok-imagine-image)
- [Perplexity](https://spiral.ai/integrations/perplexity/grok-imagine-image)
- [Raycast](https://spiral.ai/integrations/raycast/grok-imagine-image)
- [VS Code](https://spiral.ai/integrations/vscode/grok-imagine-image)
- [Windsurf](https://spiral.ai/integrations/windsurf/grok-imagine-image)
- [Zapier](https://spiral.ai/integrations/zapier/grok-imagine-image)

## More Gemini CLI guides

- [Google Virtual Try-On](https://spiral.ai/integrations/gemini-cli/google-virtual-try-on)
- [Grok Imagine Image 2.0](https://spiral.ai/integrations/gemini-cli/grok-imagine-image-2-0)
- [Gemini 2.5 Flash Image Edit](https://spiral.ai/integrations/gemini-cli/gemini-2-5-flash-image-edit)
- [Grok Imagine Image 2.0 Edit](https://spiral.ai/integrations/gemini-cli/grok-imagine-image-2-0-edit)
- [Gemini 2.5 Flash Image](https://spiral.ai/integrations/gemini-cli/gemini-2-5-flash-image)
- [Grok Imagine Image 2.0 Text to Image](https://spiral.ai/integrations/gemini-cli/grok-imagine-image-2-0-text-to-image)

## Questions about Grok Imagine Image in Gemini CLI

**Can Gemini CLI use Grok Imagine Image?**

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Grok Imagine Image like any built-in tool.

**How much does Grok Imagine Image cost in Gemini CLI?**

`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 Gemini CLI plan is separate.

**Do I need a fal account to use Grok Imagine Image in Gemini CLI?**

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 Gemini CLI?**

About two minutes: add the server, then sign in, then check it.

**Does Gemini CLI wait while Grok Imagine Image runs?**

Grok Imagine Image runs in the background. Gemini CLI 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.

