[Integrations](https://spiral.ai/integrations) › [Grok Build](https://spiral.ai/integrations/grok-build) › [Z-Image Base](https://spiral.ai/integrations/grok-build/z-image-base)

# How to Use Z-Image Base in Grok Build

Z-Image Base turns written briefs into photographs, illustrations, and concept art with control over unwanted content. Choose it when you do not need the custom LoRA support in Z-Image Base LoRA.

|  |  |
| --- | --- |
| Model | Z-Image Base |
| Available through | fal |
| Category | Image |
| Price | $0.013 per megapixel. `image_size` presets count as 1 MP; custom sizes round up to whole megapixels. Billed on `num_images`, default 1. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Z-Image Base in Grok Build

- Read the homepage copy and layout in this project. Use Z-Image Base to create a 1536 × 1024 editorial photograph that expresses the main benefit, with the subject on the right and open space on the left; start at guidance 4 and 28 steps.
- Read the onboarding screen copy. Use Z-Image Base to create a 1024 × 1024 illustration of a person organizing a cluttered workbench, with three clearly separated objects and no lettering.
- Inspect the game's environment brief. Use Z-Image Base to create a 1536 × 1024 concept image of its harbor at dawn, specifying the viewpoint, building materials, weather, and lighting; compare two compositions.
- Use Z-Image Base to create a 1024 × 1024 photographic concept of a ceramic desk lamp on an oak table, side lighting and a plain wall. Compare guidance 3 and 5 with the same seed and 28 steps, then show me the differences.
- Generate a product photo with Z-Image Base: a matte black water bottle on wet slate, soft morning light, 1:1. Tell me the price first. Save the result in ./assets.

## How to set up Z-Image Base in Grok Build

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

### Use Spiral's MCP server

1. **Add the server**: Add `--scope project` to add Spiral to the current repository only. No header and no client ID or secret: Grok registers itself with Spiral.

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

2. **Sign in**: Start `grok` and run `/mcps`. Select Spiral and press `i`. Your browser opens: sign in to Spiral, pick the organization and click Authorize. No API key.

3. **Check it**

```bash
grok mcp doctor spiral
```

### Use the Spiral skill

1. **Send Grok Build 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 Z-Image Base**: 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": "fal-ai/z-image/base",
    "input": {
      "prompt": "Grandmother knitting by a window, an empty chair by her"
    }
  }'
```

Then paste one of the prompts above: Grok Build finds Z-Image Base on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/grok-build

## Z-Image Base tools and prices

- [Z Image Base](https://spiral.ai/tools/fal/fal-ai/z-image/base) (fal): $0.013 per megapixel. `image_size` presets count as 1 MP; custom sizes round up to whole megapixels. Billed on `num_images`, default 1.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| image_size |  | landscape_4_3 | The size of the generated image. |
| num_inference_steps | 1 to 50 | 28 | The number of inference steps to perform. |
| guidance_scale | 1 to 20 | 4 | The guidance scale to use for the image generation. |
| seed |  | — | The same seed and the same prompt given to the same version of the model will output the same image every time. |
| num_images | 1 to 4 | 1 | The number of images to generate. |
| output_format | jpeg, png, webp | png | The format of the generated image. |

## What can you do with Z-Image Base in Grok Build?

Create artwork that fits the product you are building, from editorial images to onboarding illustrations. A coding agent can turn project copy and layout requirements into concrete image briefs and compare the results.

### Article illustrations

Turn an article's central idea into a photographic scene or stylized illustration. Specify one clear subject and leave space for a headline added during layout.

### Product concept images

Explore an imagined product's materials, lighting, and setting before arranging a photo shoot. Describe the object from text and compare several compositions.

### Character design exploration

Compare fictional characters with different clothing, poses, and visual treatments. Use the results to choose an art direction.

### Environment concept art

Develop settings for a game or story by specifying architecture, weather, viewpoint, and time of day. Compare photographic and illustrated treatments.

### Campaign mood boards

Explore a campaign brief through scenes with different compositions, lighting, and artistic styles. Select a direction before producing finished campaign assets.

### Website artwork

Generate editorial images for landing pages, onboarding screens, or empty states. Describe the required composition and keep interface text separate.

### Presentation cover art

Create a visual metaphor for a presentation, such as a bridge for collaboration or a greenhouse for growth. Reserve an uncluttered area for the slide title.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Grok Build guides](https://spiral.ai/integrations/grok-build)

## Z-Image Base in other agents

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

## More Grok Build guides

- [YouTube Thumbnails](https://spiral.ai/integrations/grok-build/youtube-thumbnails)
- [Z-Image Base LoRA](https://spiral.ai/integrations/grok-build/z-image-base-lora)
- [Wojak Style](https://spiral.ai/integrations/grok-build/wojak-style)
- [Z-Image Turbo](https://spiral.ai/integrations/grok-build/z-image-turbo)
- [Weather Effect](https://spiral.ai/integrations/grok-build/weather-effect)
- [Z-Image Turbo LoRA](https://spiral.ai/integrations/grok-build/z-image-turbo-lora)

## Questions about Z-Image Base in Grok Build

**Can Grok Build use Z-Image Base?**

Yes. Add Spiral to Grok Build as an MCP server, and Grok Build can find and run Z-Image Base like any built-in tool.

**How much does Z-Image Base cost in Grok Build?**

$0.013 per megapixel. `image_size` presets count as 1 MP; custom sizes round up to whole megapixels. 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 Grok Build plan is separate.

**Do I need a fal account to use Z-Image Base in Grok Build?**

No. Spiral runs Z-Image Base on its own fal account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Z-Image Base in Grok Build?**

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

**Does Grok Build wait while Z-Image Base runs?**

Z-Image Base runs in the background. Grok Build starts the run, checks on it and gives you the image when it's ready.

**What is Z-Image Base good at?**

Z-Image Base suits photographic scenes, stylized artwork, and exploring different compositions. Use it when you want several visual directions from a written brief.

**What image resolution should I use?**

The maker recommends total image areas equivalent to 512 × 512 through 2048 × 2048 pixels, with any aspect ratio. A 1024 × 1024 image is a practical starting point within that range.

**Which guidance and step settings should I start with?**

Start with guidance 4 and 28 steps, then compare the result with 50 steps. Both sit within the maker's recommended ranges of guidance 3 to 5 and 28 to 50 steps.

**How should I use negative prompts?**

Describe the scene you want in the main prompt and put unwanted elements in the negative prompt. For a clean product concept, try excluding text, watermarks, and background clutter.

**Should I turn guidance up when the image misses my brief?**

Try making the subject, placement, and lighting more explicit first. Higher guidance can strengthen prompt adherence, but it can also reduce image quality; start within the recommended 3 to 5 range.

