[Integrations](https://spiral.ai/integrations) › [Claude Code](https://spiral.ai/integrations/claude-code) › [Grok Imagine Image Edit](https://spiral.ai/integrations/claude-code/grok-imagine-image-edit)

# How to Use Grok Imagine Image Edit in Claude Code

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.

|  |  |
| --- | --- |
| Model | Grok Imagine Image Edit |
| Available through | fal |
| Category | Image |
| Price | `resolution`: 1k (default) $0.0286, 2k $0.0286 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 Edit in Claude Code

- 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.
- 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 Claude Code

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

### Use Spiral's MCP server

1. **Add the hosted server**: This adds Spiral to the current project. Add `--scope user` to use it in every project.

```bash
claude mcp add --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `claude`, type `/mcp`, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.

### Use the Spiral skill

1. **Send Claude Code 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 Edit**: 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/edit",
    "input": {
      "prompt": "Make this scene more realistic but still keep the game vibes"
    }
  }'
```

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

Setup guide in the docs: https://spiral.ai/docs/quickstarts/claude-code

## Grok Imagine Image Edit tools and prices

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

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| image_urls |  | — | List of URLs of the images to edit. A maximum of 3 images are supported. |
| 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 | auto, 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 | Aspect ratio of the edited image. When set to `auto` (the default), the output preserves the aspect ratio of the first input 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 Edit in Claude Code?

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.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Claude Code guides](https://spiral.ai/integrations/claude-code)

## Grok Imagine Image Edit in other agents

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

## More Claude Code guides

- [Grok Imagine Image 2.0 Text to Image](https://spiral.ai/integrations/claude-code/grok-imagine-image-2-0-text-to-image)
- [Grok Imagine Image Quality Edit](https://spiral.ai/integrations/claude-code/grok-imagine-image-quality-edit)
- [Grok Imagine Image 2.0 Edit](https://spiral.ai/integrations/claude-code/grok-imagine-image-2-0-edit)
- [Grok Imagine Image Quality Text to Image](https://spiral.ai/integrations/claude-code/grok-imagine-image-quality-text-to-image)
- [Grok Imagine Image 2.0](https://spiral.ai/integrations/claude-code/grok-imagine-image-2-0)
- [Hair Change](https://spiral.ai/integrations/claude-code/hair-change)

## Questions about Grok Imagine Image Edit in Claude Code

**Can Claude Code use Grok Imagine Image Edit?**

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

**How much does Grok Imagine Image Edit cost in Claude Code?**

`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 Claude Code plan is separate.

**Do I need a fal account to use Grok Imagine Image Edit in Claude Code?**

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 Claude Code?**

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

**Does Claude Code wait while Grok Imagine Image Edit runs?**

Grok Imagine Image Edit runs in the background. Claude Code 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.

