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

Windsurf · Image

How to Use Boogu Image in Windsurf

Boogu Image creates posters, document layouts, photos, and illustrations from text, with support for Chinese and English lettering. Use detailed descriptions, and proofread dense text for missing characters or layout errors.

Prompts to try with Boogu Image in Windsurf

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

Read the event brief in this project and use Boogu Image to make a 1024 × 1024 poster concept. Include only the event title as lettering, centered above a paper-cut illustration inspired by the brief.

Boogu ImageWindsurf
Try asking
  • Read the homepage copy and use Boogu Image to create a 1536 × 1024 editorial photo concept. Describe one scene that expresses the main idea, with natural window light and open space on the left.

  • Use the project's design notes to brief Boogu Image on a 1024 × 1024 brand guide concept. Show the approved palette and the short heading 'Color and type.' Keep the layout spacious.

  • Find the approved Chinese and English campaign headlines in the project. Use Boogu Image to make a 1024 × 1536 poster with those exact lines, Chinese above English, and a restrained ink illustration below.

  • Read the latest release notes and use Boogu Image to create a 1536 × 1024 illustrated announcement cover. Choose one visual metaphor for the main change, use a woodcut style, and leave lettering out.

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

    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/boogu-image",
        "input": {
          "prompt": "A street photography shot of an elderly scavenger with a deeply weathered face in the center of the frame, a trash can and a traffic light in the background.…"
        }
      }'

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

Boogu Image providers and prices

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

falImage

Settings you can ask for

Boogu Image works from your prompt. Ask Windsurf for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Negative promptwhat to leave out, in words

Describes what should NOT appear in the image. Used for classifier-free guidance; leave empty to disable text negative guidance.

Number of inference steps20 to 5030

The number of denoising steps to perform.

Guidance scale1 to 84

Controls how closely generation follows the text instruction. Higher values stick more closely to the prompt. A value of 1.0 disables text classifier-free guidance.

CFG range start0 to 10

Start of the timestep fraction over which CFG is applied.

CFG range end0 to 11

End of the timestep fraction over which CFG is applied.

Number of images1 to 41

The number of images to generate.

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.

Output formatjpeg or pngjpeg

The format of the generated image.

Every API field of Boogu Image · Text to Image is on its tool page: open its card above.

What can you do with Boogu Image in Windsurf?

Turn project copy and design notes into poster, cover, or editorial image concepts with Boogu Image. A coding agent can read the relevant files and turn their content into a detailed visual brief.

Event poster concepts

Draft a poster from an event description, with a clear headline and a small amount of supporting copy. Check every date and letter before using it.

Chinese and English campaign artwork

Explore artwork containing supplied Chinese and English headlines. Specify the placement and relative size of each language.

Document layout studies

Test the visual hierarchy of a title page or short information sheet before rebuilding the chosen layout in a document editor.

Brand guide concepts

Explore a brand guide page using a written palette, typography direction, and short sample headings.

Editorial photo concepts

Turn a written article brief into a photographic scene with specified framing, lighting, and background details.

Illustrated covers

Explore a cover in a chosen artistic medium, with a defined focal subject and space for the title.

Questions about Boogu Image in Windsurf

Can Windsurf use Boogu Image?

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

How much does Boogu Image cost in Windsurf?

$0.052 per megapixel. `image_size` presets count as 1 MP; custom sizes round up to whole megapixels. Billed on `num_images`, default 1. 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 Boogu Image in Windsurf?

No. Spiral runs Boogu 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 Boogu Image in Windsurf?

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

Does Windsurf wait while Boogu Image runs?

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

What is Boogu Image useful for?

Try posters, document concepts, bilingual lettering, editorial photos, and illustrated covers. Describe the intended layout as carefully as the subject.

Can Boogu Image write Chinese and English in an image?

Yes. It supports Chinese and English text rendering, though generated lettering still needs proofreading before use.

How large can Boogu Image generate?

Its maximum native resolution is 2K. Asking for a larger image is clamped to that limit.

Why does Boogu Image sometimes misspell text?

Long passages, small fonts, dense typography, and complex layouts remain documented weaknesses. Shorten the copy and simplify the layout when letters go missing or text shifts.

How should I prompt Boogu Image?

Use a detailed description of the subject, composition, lighting, colors, and intended lettering. For example, specify where a headline belongs and provide its exact wording.

Get started

Start using Boogu Image 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