Spiral gives your agent every tool with one account. Browse the tools →

Gemini CLI · Image

How to Use Recraft V4.1 Pro in Gemini CLI

Recraft V4.1 Pro suits campaign images, website heroes, and artwork that needs finer detail. It produces higher-resolution images than Recraft V4.1, including 2048×2048 square output.

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

Copy an example into Gemini CLI, or ask in your own words.

Use Recraft V4.1 Pro to generate a 2048×2048 campaign image for the coffee product described in this project's brief: an unbranded matte bag beside a ceramic cup, directional morning light, visible paper texture, no lettering.

Recraft V4.1 ProGemini CLI
Try asking
  • Read the homepage copy and layout in this project. Use Recraft V4.1 Pro to create a landscape editorial photo of a ceramic workshop, with the workbench on the left and clear space on the right for the existing headline.

  • Read the article about task overload in this project. Use Recraft V4.1 Pro to create an editorial illustration of a small paper boat navigating stacks of paperwork, using the site's existing colors.

  • Use Recraft V4.1 Pro to explore three separate hero concepts for this project's gardening app: a sunlit potting bench, a close-up seedling, and an illustrated rooftop garden. Keep open space for HTML text.

  • Inspect the onboarding copy and color tokens in this project. Use Recraft V4.1 Pro to create a square illustration of a person organizing a cluttered desk, with simple shapes and a plain background.

How to set up Recraft V4.1 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:

    gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start gemini and run:

    /mcp auth spiral
  3. Check it

    In Gemini CLI, run /mcp. From your shell:

    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.

    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 Pro

    One request; the result comes back by polling or a webhook.

    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/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 Pro on Spiral, shows the price and runs it.

Recraft V4.1 Pro providers and prices

Spiral runs Recraft V4.1 Pro through fal. Open a card for today's price, with every fee included.

falImage
Recraft V4.1 Pro · Text to Image
fal-ai/recraft/v4.1/pro/text-to-image

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

Create artwork that fits the page or app you are building. A coding agent can turn project copy and layout requirements into briefs for editorial images, illustrations, and campaign concepts.

Website hero artwork

Create a photographic or illustrated scene with the subject on one side and open space for a headline added in the page layout.

Editorial illustrations

Turn an article's central idea into a visual metaphor, such as a paper boat navigating a crowded desk for a story about managing workload.

Campaign concept exploration

Explore several lighting, material, and composition directions for the same campaign brief before choosing an approach.

Product photography concepts

Visualize a fictional ceramic cup, watch, or skincare bottle in a described setting to plan a shoot or presentation.

Portrait art direction

Explore wardrobe, framing, background, and lighting for an editorial portrait using a fictional adult subject.

Environment concept art

Describe a bookstore, workshop, or imagined landscape and explore its atmosphere, spatial arrangement, and materials.

Mixed-media social artwork

Combine a photographic subject with cut-paper shapes or illustrated elements, leaving captions for the final layout.

Higher-resolution campaign artwork

Generate a 2048×2048 square campaign image when the final composition needs more pixels and finer detail.

Questions about Recraft V4.1 Pro in Gemini CLI

Can Gemini CLI use Recraft V4.1 Pro?

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

How much does Recraft V4.1 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 Pro in Gemini CLI?

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

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

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

Recraft V4.1 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 useful for?

Use it for editorial imagery, campaign concepts, illustrations, and art-directed photography. Give the prompt a subject, a visual treatment, and a clear composition.

Should I write a short prompt or a detailed brief?

Start short when exploring a visual direction. For a specific deliverable, describe the framing, materials, lighting, background, and space needed for surrounding copy.

How should I prompt words inside an image?

Put the exact wording in quotation marks and describe its size and placement. Check the rendered letters before using the image, especially with the original Recraft V4.1 Flash.

Will these text-to-image models return an editable SVG?

These Recraft V4.1 text-to-image models produce raster artwork. For a logo concept, treat the result as an image rather than editable vector paths.

Why does the model add an unexpected camera angle or lighting treatment?

Recraft V4.1 makes creative choices about light, mood, and composition. If a particular arrangement matters, specify the camera position, subject placement, and lighting direction instead of leaving them open.

Get started

Start using Recraft V4.1 Pro in Gemini CLI

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Gemini CLI:

Set up Gemini CLI

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options