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

Windsurf · Image

How to Use Cartoonify in Windsurf

Cartoonify turns existing photos into cartoons with bold outlines and rich colors. Use it for illustrated avatars, editorial images, and social graphics when you want a visibly drawn treatment.

Prompts to try with Cartoonify in Windsurf

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

Use Cartoonify on the portrait in this project's assets to make a square author avatar. Show the result beside the original in a local preview.

CartoonifyWindsurf
Try asking
  • Use Cartoonify to convert the blog's lead photograph into cartoon artwork. Choose a 16:9 frame and preview it in the article header.

  • Use Cartoonify on the pet photo in the demo assets. Create a square result and show it at the profile component's actual display size.

  • Use Cartoonify to give the project's campaign photograph a cartoon treatment in a 9:16 frame. Preview it in the mobile story layout.

  • Use Cartoonify on the travel photograph used by the gallery page. Keep the original available and build a side-by-side comparison for review.

How to set up Cartoonify 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 Cartoonify

    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/image-editing/cartoonify",
        "input": {
          "image_url": "https://v3.fal.media/files/zebra/hAjCkcyly4gsS9-cptD3Y_image%20(20).png"
        }
      }'

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

Cartoonify providers and prices

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

falImage
Image Editing Cartoonify
fal-ai/image-editing/cartoonify

Settings you can ask for

Cartoonify works from your image URL. Ask Windsurf for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Guidance scale0 to 203.5

The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show you.

Number of inference steps1 to 5030

Number of inference steps for sampling.

Safety tolerance1 to 62

The safety tolerance level for the generated image. 1 being the most strict and 6 being the most permissive.

Output formatjpeg or pngjpeg

The format of the generated image.

Aspect ratio21:9, 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16 and 1 more

The aspect ratio of the generated image.

Seeda whole number

The same seed and the same prompt given to the same version of the model will output the same image every time.

Every API field of Image Editing Cartoonify is on its tool page: open its card above.

What can you do with Cartoonify in Windsurf?

Create cartoon artwork from photos already used in your project. Your coding agent can prepare the images, compare the results in the actual layout, and place the selected artwork.

Illustrated profile pictures

Turn a portrait photo into a cartoon avatar. Review the face at the small size used by the destination app before choosing the final image.

Editorial photo treatments

Convert an article's existing photograph into cartoon artwork. Add the headline and caption during page layout.

Social post artwork

Give a campaign photograph a drawn treatment for a social post. Choose the output shape for the intended placement.

Pet portraits

Use a pet photograph as the starting point for a cartoon portrait for a personal gallery or greeting card.

Travel journal illustrations

Turn selected vacation photographs into cartoon illustrations for a travel journal. Keep place names and descriptive text in the surrounding layout.

Photo-based video thumbnails

Convert a photograph into cartoon artwork for a video thumbnail. Check the result at thumbnail size, then add titles in an editor.

Questions about Cartoonify in Windsurf

Can Windsurf use Cartoonify?

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

How much does Cartoonify cost in Windsurf?

$0.052 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 Cartoonify in Windsurf?

No. Spiral runs Cartoonify on its own fal account. You sign in to Spiral once and never paste a key.

How long does it take to set up Cartoonify in Windsurf?

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

Does Windsurf wait while Cartoonify runs?

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

What does Cartoonify do to a photo?

It converts the photo into cartoon artwork with bold outlines and rich colors. Consider it for an illustrated profile picture or a drawn treatment of an existing photograph.

How should I prompt Cartoonify?

Treat the source photo as the creative brief. Choose the subject and composition before conversion, then tell your agent where you plan to use the result.

Is Cartoonify suitable for subtle photographic retouching?

Its stated treatment emphasizes bold outlines and rich colors. Choose it when that visible cartoon effect suits the image; for subtle retouching, look for a tool designed to preserve a photographic appearance.

Can I reproduce a Cartoonify result?

The documentation says the same seed and prompt produce the same image on the same model version. Keep the source image and other settings unchanged when checking reproducibility.

What is Cartoonify's maximum output resolution?

The documentation does not publish a maximum output resolution. Inspect the returned image dimensions before choosing a print size or enlarging the result.

Get started

Start using Cartoonify 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