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

Windsurf · Image

How to Use Recraft 20B in Windsurf

Recraft 20B, also called Recraft V2, makes icons, textured illustrations, and vector artwork with brand color control. Compared with Recraft V3, it is less reliable at following detailed prompts and rendering text.

Prompts to try with Recraft 20B in Windsurf

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

Use Recraft 20B to create a square vector illustration of an open folder for the project's empty document screen. Read the design tokens for preferred colors, use a flat style, and keep lettering out of the artwork.

Recraft 20BWindsurf
Try asking
  • Read the onboarding copy and use Recraft 20B to generate one illustration per step. Use the same digital illustration style, palette, and centered framing throughout; keep instructions as interface text.

  • Use Recraft 20B to create a 1024 × 1024 photographic concept for the recipe project's homepage: a bowl of tomato soup on a wooden table, viewed from above, with soft window light.

  • Inspect the project's navigation and use Recraft 20B to explore simple vector icons for search, bookmarks, and delivery. Request each separately with the same line art style and preferred colors, then show them together for review.

  • Use Recraft 20B to make a grain-textured illustration for the project's article about calendar overload: a crowded paper calendar beside a single clear day. Keep the brief under 1,000 characters and add the title through the page layout.

How to set up Recraft 20B in Windsurf

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

Use Spiral's MCP server

  1. Add the server

    Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: ~/.config/devin/mcp_config.json on macOS and Linux, %APPDATA%\devin\mcp_config.json on Windows. Add this:

    {
      "mcpServers": {
        "spiral": {
          "url": "https://api.spiral.ai/mcp"
        }
      }
    }
  2. Sign in

    Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.

    devin mcp login spiral
  3. Check it

    Spiral is listed under This computer in Customize › MCPs. From the terminal:

    devin mcp list

Use the Spiral skill

  1. Send Windsurf 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 20B

    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-20b",
        "input": {
          "prompt": "a red panda in Kyoto"
        }
      }'

Then paste one of the prompts above: Windsurf finds Recraft 20B on Spiral, shows the price and runs it.

Recraft 20B providers and prices

Spiral runs Recraft 20B through fal. Open a card for today's price, with every fee included.

falImage
Recraft 20b
fal-ai/recraft-20b

Settings you can ask for

Recraft 20B works from your prompt. Ask Windsurf for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Styleany, realistic_image, digital_illustration, vector_illustration, realistic_image/b_and_w, realistic_image/enterprise, realistic_image/hard_flash, realistic_image/hdr and 29 morerealistic_image

The style of the generated images. Vector images cost 2X as much.

Every API field of Recraft 20b is on its tool page: open its card above.

What can you do with Recraft 20B in Windsurf?

Turn interface requirements into icons and illustrations that fit the project. Use the project's design tokens and screen content to write focused briefs, then review the generated assets in context.

App icon concepts

Create simple symbols for search, saved items, delivery, or account screens. Keep the visual brief consistent and review the icons together before using them.

Onboarding illustrations

Illustrate actions such as organizing tasks or saving a document with a shared style and palette. Add instructional text in the interface.

Editorial artwork

Turn an article's central idea into a textured illustration, such as a tangled calendar for an essay about overcommitment.

Presentation graphics

Generate coordinated illustrations for topics such as planning, collaboration, and delivery. Keep slide titles and data labels separate from the artwork.

Brand symbol exploration

Explore simple vector symbols for a business, publication, or event. Develop the lettering separately when the name must be exact.

Social post artwork

Create a series of illustrations around one campaign theme using a shared visual treatment. Leave space for captions added during layout.

Photographic concepts

Explore photographic scenes for an article or creative brief, such as a ceramic cup beside a window. Describe the light, materials, and viewing angle.

Questions about Recraft 20B in Windsurf

Can Windsurf use Recraft 20B?

Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run Recraft 20B like any built-in tool.

How much does Recraft 20B cost in Windsurf?

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

Do I need a fal account to use Recraft 20B in Windsurf?

No. Spiral runs Recraft 20B 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 20B in Windsurf?

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

Does Windsurf wait while Recraft 20B runs?

Recraft 20B runs in the background. Windsurf starts the run, checks on it and gives you the image when it's ready.

What is Recraft 20B best for?

Start with minimalistic icons, textured illustrations, and vector artwork. It also suits coordinated graphics that share a visual style and brand palette.

Is Recraft 20B the same as Recraft V2?

Yes. Recraft documents V2 as its 20-billion-parameter image model.

Can Recraft 20B render accurate text?

Text accuracy is a documented weakness, and Recraft V3 handles it better. For a graphic that needs exact wording, generate the artwork first and add the lettering separately.

How should I write a Recraft 20B prompt?

Start with the subject, then describe its position, viewing angle, and surroundings. Keep the brief focused and within Recraft's documented 1,000-character V2 limit.

How do I get closer to my brand colors?

Use a simple subject and a restrained style when palette matching matters. Recraft warns that complex prompts and styles make limited palettes harder to follow, so inspect the result before using it.

Get started

Start using Recraft 20B in Windsurf

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

Paste this into Windsurf:

Set up Windsurf

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