[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [Recraft V4.1 Utility](https://spiral.ai/integrations/gemini-cli/recraft-v4-1-utility)

# How to Use Recraft V4.1 Utility in Gemini CLI

Recraft V4.1 Utility makes straightforward product shots, mockups, and graphics for repeated creative work. It generates at 1K, while Recraft V4.1 Utility Pro adds 2K output and finer detail.

|  |  |
| --- | --- |
| Model | Recraft V4.1 Utility |
| Available through | fal |
| Category | Image |
| Price | $0.0455 per image. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Recraft V4.1 Utility in Gemini CLI

- Read the onboarding copy in this project, then use Recraft V4.1 Utility to create a square illustration of a small seedling for the first screen. Use flat shapes, muted green and cream, a calm mood, and no lettering.
- Read the empty-state requirements, then use Recraft V4.1 Utility to create a simple ink illustration of an open mailbox. Center it on white with generous margins and no lettering.
- Use Recraft V4.1 Utility to explore three product-image compositions from the project brief, generating each separately. Keep the object and lighting description fixed; change only its placement in the frame.
- Use Recraft V4.1 Utility to generate a square concept image for the ceramic mug described in the product brief. Show the full object from the front, with even studio lighting and a plain white background.
- Use Recraft V4.1 Utility to create a front-facing blank cardboard box mockup for the packaging page in this project. Show the full box, natural paper texture, even lighting, and a neutral background.

## How to set up Recraft V4.1 Utility 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 Recraft V4.1 Utility**: 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/recraft/v4.1/utility/text-to-image",
    "input": {
      "prompt": "Tilt-shift miniature effect on a real Portuguese fishing village at golden hour, colorful boats in the harbor appearing toy-like, selective focus band across…"
    }
  }'
```

Then paste one of the prompts above: Gemini CLI finds Recraft V4.1 Utility on Spiral, shows the price and runs it.

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

## Recraft V4.1 Utility tools and prices

- [Recraft V4.1 Utility · Text to Image](https://spiral.ai/tools/fal/fal-ai/recraft/v4.1/utility/text-to-image) (fal): $0.0455 per image.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| image_size |  | square_hd |  |
| colors |  | [] | An array of preferable colors |
| background_color |  | — | The preferable background color of the generated images. |

## What can you do with Recraft V4.1 Utility in Gemini CLI?

Create product mockups and app illustration concepts from the project's written requirements. Use Recraft V4.1 Utility for simple scenes, with explicit framing and material instructions.

### Product concept images

Turn a written product idea into a front-facing studio image with a plain background and clearly described materials.

### Blank packaging mockups

Generate unprinted boxes, bottles, or pouches to explore packaging shapes before adding artwork.

### Creative A/B exploration

Explore a product concept with different backgrounds or subject placements, changing one part of the brief at a time.

### App illustration concepts

Create simple illustrations for onboarding or empty states from written briefs. Specify the medium, subject, and mood.

### Material studies

Compare a proposed object's appearance in ceramic, brushed metal, or matte plastic using the same framing and lighting brief.

### Presentation mockups

Generate simple, unbranded product scenes for pitch decks, with enough space around the object for slide text.

## Overview

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

## Recraft V4.1 Utility in other agents

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

## More Gemini CLI guides

- [Recraft V4.1 Pro Vector](https://spiral.ai/integrations/gemini-cli/recraft-v4-1-pro-vector)
- [Recraft V4.1 Utility Pro](https://spiral.ai/integrations/gemini-cli/recraft-v4-1-utility-pro)
- [Recraft V4.1 Pro](https://spiral.ai/integrations/gemini-cli/recraft-v4-1-pro)
- [Recraft V4.1 Vector](https://spiral.ai/integrations/gemini-cli/recraft-v4-1-vector)
- [Recraft V4.1 Flash](https://spiral.ai/integrations/gemini-cli/recraft-v4-1-flash)
- [Recraft Vectorize](https://spiral.ai/integrations/gemini-cli/recraft-vectorize)

## Questions about Recraft V4.1 Utility in Gemini CLI

**Can Gemini CLI use Recraft V4.1 Utility?**

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Recraft V4.1 Utility like any built-in tool.

**How much does Recraft V4.1 Utility cost in Gemini CLI?**

$0.0455 per image. 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 Recraft V4.1 Utility in Gemini CLI?**

No. Spiral runs Recraft V4.1 Utility on its own fal account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Recraft V4.1 Utility in Gemini CLI?**

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

**Does Gemini CLI wait while Recraft V4.1 Utility runs?**

Recraft V4.1 Utility runs in the background. Gemini CLI starts the run, checks on it and gives you the image when it's ready.

**What is Recraft V4.1 Utility best for?**

Simple product shots, blank mockups, and straightforward graphics. Its flat lighting and front-facing compositions suit work where the subject needs to be easy to see.

**When should I choose Recraft V4.1 Utility Pro?**

Choose Pro when you need higher resolution and finer detail. Recraft V4.1 Utility produces 1K raster images; Pro produces 2K raster images.

**What are the square output dimensions?**

Recraft documents 1024 × 1024 pixels for Recraft V4.1 Utility and 2048 × 2048 pixels for Recraft V4.1 Utility Pro.

**Can Recraft V4.1 Utility create editable SVG files?**

These two models produce raster images. Choose a Recraft Vector model when the deliverable needs editable SVG paths.

**How detailed should my prompt be?**

Start short when exploring an idea. For a specific result, describe the subject, background, framing, materials, and lighting; both models support prompts up to 10,000 characters.

