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

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

Recraft V4.1 Utility Pro makes simple product images and mockups with finer detail for larger assets. Compared with Recraft V4.1 Utility, it generates at 2K rather than 1K.

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

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

- Use Recraft V4.1 Utility Pro 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 Pro 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.
- Read the onboarding copy in this project, then use Recraft V4.1 Utility Pro 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 Pro 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 Pro 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.

## How to set up Recraft V4.1 Utility Pro 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 Pro**: 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/pro/text-to-image",
    "input": {
      "prompt": "Crash zoom frozen at the moment of impact as a kingfisher breaks the surface of a pond, water crown splash forming a perfect circle, the bird'\''s beak piercing…"
    }
  }'
```

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

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

## Recraft V4.1 Utility Pro tools and prices

- [Recraft V4.1 Utility Pro · Text to Image](https://spiral.ai/tools/fal/fal-ai/recraft/v4.1/utility/pro/text-to-image) (fal): $0.273 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 Pro 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 Pro in other agents

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

## More Gemini CLI guides

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

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

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

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

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

$0.273 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 Pro in Gemini CLI?**

No. Spiral runs Recraft V4.1 Utility Pro 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 Pro in Gemini CLI?**

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

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

Recraft V4.1 Utility Pro 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.

