[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [Recraft V3 Text to Image](https://spiral.ai/integrations/gemini-cli/recraft-v3-text-to-image)

# How to Use Recraft V3 Text to Image in Gemini CLI

Use Recraft V3 Text to Image for posters, editorial illustrations, and visual concepts with embedded text. Unlike Recraft V3 Image to Image, it builds the scene from a written brief without a source image.

|  |  |
| --- | --- |
| Model | Recraft V3 Text to Image |
| Available through | fal |
| Category | Image |
| Price | $0.052 per image. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Recraft V3 Text to Image in Gemini CLI

- Read the project's onboarding copy and palette, then use Recraft V3 Text to Image to create a 1024 × 1024 editorial illustration for the first screen. Show three envelopes arranged around one open mailbox, using the project's colors.
- Read the event details in the project, then use Recraft V3 Text to Image to create a poster concept. Put the event title in quotation marks in the visual brief, keep that brief under 1,000 characters, and flag lettering that needs correction.
- Use Recraft V3 Text to Image to create three separate article illustrations based on the project's article summaries. Reuse one established illustration style and palette, and keep each visual brief under 1,000 characters.
- Generate a product photo with Recraft V3 Text to Image: a matte black water bottle on wet slate, soft morning light, 1:1. Tell me the price first. Save the result in ./assets.
- Make four logo concepts for a coffee brand called "Northline" with Recraft V3 Text to Image.

## How to set up Recraft V3 Text to Image 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 V3 Text to Image**: 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/v3/text-to-image",
    "input": {
      "prompt": "a red panda eating a bamboo in front of a poster that says \"recraft V3 now available at fal\""
    }
  }'
```

Then paste one of the prompts above: Gemini CLI finds Recraft V3 Text to Image on Spiral, shows the price and runs it.

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

## Recraft V3 Text to Image tools and prices

- [Recraft V3 · Text to Image](https://spiral.ai/tools/fal/fal-ai/recraft/v3/text-to-image) (fal): $0.052 per image.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| image_size |  | square_hd |  |
| style | any, realistic_image, digital_illustration, vector_illustration, realistic_image/b_and_w, realistic_image/hard_flash, realistic_image/hdr, realistic_image/natural_light, realistic_image/studio_portrait, realistic_image/enterprise, realistic_image/motion_blur, realistic_image/evening_light, realistic_image/faded_nostalgia, realistic_image/forest_life, realistic_image/mystic_naturalism, realistic_image/natural_tones, realistic_image/organic_calm, realistic_image/real_life_glow, realistic_image/retro_realism, realistic_image/retro_snapshot, realistic_image/urban_drama, realistic_image/village_realism, realistic_image/warm_folk, digital_illustration/pixel_art, digital_illustration/hand_drawn, digital_illustration/grain, digital_illustration/infantile_sketch, digital_illustration/2d_art_poster, digital_illustration/handmade_3d, digital_illustration/hand_drawn_outline, digital_illustration/engraving_color, digital_illustration/2d_art_poster_2, digital_illustration/antiquarian, digital_illustration/bold_fantasy, digital_illustration/child_book, digital_illustration/child_books, digital_illustration/cover, digital_illustration/crosshatch, digital_illustration/digital_engraving, digital_illustration/expressionism, digital_illustration/freehand_details, digital_illustration/grain_20, digital_illustration/graphic_intensity, digital_illustration/hard_comics, digital_illustration/long_shadow, digital_illustration/modern_folk, digital_illustration/multicolor, digital_illustration/neon_calm, digital_illustration/noir, digital_illustration/nostalgic_pastel, digital_illustration/outline_details, digital_illustration/pastel_gradient, digital_illustration/pastel_sketch, digital_illustration/pop_art, digital_illustration/pop_renaissance, digital_illustration/street_art, digital_illustration/tablet_sketch, digital_illustration/urban_glow, digital_illustration/urban_sketching, digital_illustration/vanilla_dreams, digital_illustration/young_adult_book, digital_illustration/young_adult_book_2, vector_illustration/bold_stroke, vector_illustration/chemistry, vector_illustration/colored_stencil, vector_illustration/contour_pop_art, vector_illustration/cosmics, vector_illustration/cutout, vector_illustration/depressive, vector_illustration/editorial, vector_illustration/emotional_flat, vector_illustration/infographical, vector_illustration/marker_outline, vector_illustration/mosaic, vector_illustration/naivector, vector_illustration/roundish_flat, vector_illustration/segmented_colors, vector_illustration/sharp_contrast, vector_illustration/thin, vector_illustration/vector_photo, vector_illustration/vivid_shapes, vector_illustration/engraving, vector_illustration/line_art, vector_illustration/line_circuit, vector_illustration/linocut | realistic_image | The style of the generated images. Vector images cost 2X as much. |
| colors |  | [] | An array of preferable colors |
| style_id |  | — | The ID of the custom style reference (optional) |

## What can you do with Recraft V3 Text to Image in Gemini CLI?

Build website illustrations and campaign artwork from the project's visual requirements with Recraft V3. A coding agent can use the project's copy and palette to write concrete image briefs and review the results in context.

### Event poster concepts

Develop a poster with an illustrated subject and an embedded event title. Start from a written brief or rework an existing poster image.

### Editorial illustrations

Illustrate an article's central idea with a specific arrangement of objects. Create the scene from a description or reinterpret an existing visual.

### Campaign graphics

Develop graphics around an established visual style and color palette. Use a written campaign brief or an existing campaign image as the starting point.

### Website illustrations

Create an illustration for an onboarding screen or article header. Describe the intended scene or restyle an existing illustration to match the site's direction.

### Photographic advertising concepts

Explore a photographic scene with specified subjects, colors, and object placement. Work from a written concept or reinterpret an existing photo.

### Presentation artwork

Develop a visual metaphor for a presentation, such as three separate paths converging on one destination. Generate it from a brief or adapt an existing image.

### New scenes from a written brief

Explore a visual idea before any source artwork exists. Specify the subject, object count, palette, and embedded wording in one concise description.

## Overview

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

## Recraft V3 Text to Image in other agents

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

## More Gemini CLI guides

- [Recraft V3 Image to Image](https://spiral.ai/integrations/gemini-cli/recraft-v3-image-to-image)
- [Recraft V4](https://spiral.ai/integrations/gemini-cli/recraft-v4)
- [Recraft Crisp Upscale](https://spiral.ai/integrations/gemini-cli/recraft-crisp-upscale)
- [Recraft V4 Pro](https://spiral.ai/integrations/gemini-cli/recraft-v4-pro)
- [Recraft Creative Upscale](https://spiral.ai/integrations/gemini-cli/recraft-creative-upscale)
- [Recraft V4 Pro Vector](https://spiral.ai/integrations/gemini-cli/recraft-v4-pro-vector)

## Questions about Recraft V3 Text to Image in Gemini CLI

**Can Gemini CLI use Recraft V3 Text to Image?**

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Recraft V3 Text to Image like any built-in tool.

**How much does Recraft V3 Text to Image cost in Gemini CLI?**

$0.052 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 V3 Text to Image in Gemini CLI?**

No. Spiral runs Recraft V3 Text to Image 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 V3 Text to Image in Gemini CLI?**

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

**Does Gemini CLI wait while Recraft V3 Text to Image runs?**

Recraft V3 Text to Image runs in the background. Gemini CLI starts the run, checks on it and gives you the image when it's ready.

**What is Recraft V3 useful for?**

Recraft V3 suits posters, editorial illustrations, photographic concepts, and designs with embedded lettering. Its scene following also makes it useful when a brief specifies object counts, colors, and placement.

**Can Recraft V3 generate readable text inside an image?**

Yes. Text rendering is a documented strength, including longer passages. Put the exact wording in quotation marks and check the result before using it.

**How detailed should a Recraft V3 prompt be?**

Keep it within 1,000 characters. Describe the subject, then specify the important counts, colors, and positions so the visual brief is concrete.

**Can Recraft V3 keep a consistent visual style across several images?**

Yes. Recraft V3 supports style consistency from example images without retraining. Reuse the same established style when producing a campaign or illustration series.

**Is Recraft V3 only useful for illustrations?**

No. Photorealism and text rendering are also documented strengths, so briefs can call for photographic scenes as well as illustrated designs.

