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

Gemini CLI · Image

How to Use Grok Imagine Image Edit in Gemini CLI

Grok Imagine Image Edit revises existing artwork with written instructions. Unlike Grok Imagine Image, it starts with supplied images, making it useful for changing a scene while asking to retain its composition.

Prompts to try with Grok Imagine Image Edit in Gemini CLI

Copy an example into Gemini CLI, or ask in your own words.

Use Grok Imagine Image Edit on the existing workshop concept in the project. Replace the loose tools on the floor with two wooden storage crates. Ask to preserve the camera position, doorway, workbench proportions, and lighting; return a 2K image.

Grok Imagine Image EditGemini CLI
Try asking
  • Use Grok Imagine Image Edit on the project's article illustration. Change the scene from midday to early evening with warm light from the left. Keep the subject placement and framing, return a 2K image, and show it in the article layout for review.

  • Remove the background from the photo I attach with Grok Imagine Image Edit and give me a transparent PNG. Save the result in ./assets.

  • Use Grok Imagine Image Edit to clean up these product shots so they sit on pure white.

  • Edit this image with Grok Imagine Image Edit: keep the subject, swap the background for a sunlit studio.

How to set up Grok Imagine Image Edit 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:

    gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start gemini and run:

    /mcp auth spiral
  3. Check it

    In Gemini CLI, run /mcp. From your shell:

    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.

    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 Edit

    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/edit",
        "input": {
          "prompt": "Make this scene more realistic but still keep the game vibes"
        }
      }'

Then paste one of the prompts above: Gemini CLI finds Grok Imagine Image Edit on Spiral, shows the price and runs it.

Grok Imagine Image Edit providers and prices

Spiral runs Grok Imagine Image Edit through fal. Open a card for today's price, with every fee included.

falImage
Grok Imagine Image · Edit Image
xai/grok-imagine-image/edit

Settings you can ask for

Grok Imagine Image Edit works from your prompt and image URLs. Ask Gemini CLI for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Image passthroughon or offoff

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 images1 to 41

Number of images to generate.

Aspect ratioauto, 2:1, 20:9, 19.5:9, 16:9, 4:3, 3:2, 1:1 and 6 moreauto

Aspect ratio of the edited image. When set to auto (the default), the output preserves the aspect ratio of the first input image.

Resolution1k or 2k1k

Resolution of the generated image. 1k for standard resolution, 2k for high resolution.

Output formatjpeg, png, or webpjpeg

The format of the generated image.

Every API field of Grok Imagine Image · Edit Image is on its tool page: open its card above.

What can you do with Grok Imagine Image Edit 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.

Scene revisions

Revise supplied artwork with a focused instruction. Name the requested change and the camera position, proportions, and framing you want retained.

Architectural image cleanup

Remove temporary construction clutter from a supplied building image for a proposed presentation. Ask to preserve the building's proportions and perspective, then inspect the reconstructed areas.

Questions about Grok Imagine Image Edit in Gemini CLI

Can Gemini CLI use Grok Imagine Image Edit?

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

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

`resolution`: 1k (default) $0.0286, 2k $0.0286 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 Edit in Gemini CLI?

No. Spiral runs Grok Imagine Image Edit 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 Edit in Gemini CLI?

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

Does Gemini CLI wait while Grok Imagine Image Edit runs?

Grok Imagine Image Edit 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.

Get started

Start using Grok Imagine Image Edit in Gemini CLI

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Gemini CLI:

Set up Gemini CLI

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options