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

Claude Code · Image

How to Use Recraft V4.1 Pro in Claude Code

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 Claude Code

Copy an example into Claude Code, 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 ProClaude Code
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 Claude Code

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

Use Spiral's MCP server

  1. Add the hosted server

    This adds Spiral to the current project. Add --scope user to use it in every project.

    claude mcp add --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start claude, type /mcp, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.

Use the Spiral skill

  1. Send Claude Code 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: Claude Code 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 Claude Code?

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 Claude Code

Can Claude Code use Recraft V4.1 Pro?

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

How much does Recraft V4.1 Pro cost in Claude Code?

$0.273 per image. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Claude Code plan is separate.

Do I need a fal account to use Recraft V4.1 Pro in Claude Code?

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 Claude Code?

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

Does Claude Code wait while Recraft V4.1 Pro runs?

Recraft V4.1 Pro runs in the background. Claude Code 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 Claude Code

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

Paste this into Claude Code:

Set up Claude Code

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