How to Use Nano Banana in Windsurf
Use Nano Banana to create illustrations, product concepts, and scene drafts from text. It is Google's original Gemini 2.5 Flash Image model, with roughly 1K output rather than Pro's higher resolutions.
Prompts to try with Nano Banana in Windsurf
Copy an example into Windsurf, or ask in your own words.
Use Nano Banana to create a square illustration for this project's empty search state: a librarian looking through an empty card catalog, drawn in ink with two muted colors. Match the palette in the project's styles and include no lettering.
Generate a product photo with Nano Banana: a matte black water bottle on wet slate, soft morning light, 1:1. Tell me the price first. Save the result in ./assets.
Make four logo concepts for a coffee brand called "Northline" with Nano Banana.
Create a 16:9 hero image of a quiet mountain cabin at dusk with Nano Banana.
Generate a 9:16 poster with Nano Banana for a jazz night called "Blue Hour", deep navy and brass tones.
How to set up Nano Banana in Windsurf
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- 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" } } } - 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
- Check it
Spiral is listed under This computer in Customize › MCPs. From the terminal:
devin mcp list
Use the Spiral skill
- Send Windsurf this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- 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
- Create an API key
In the console, under API keys.
- Run Nano Banana
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/nano-banana", "input": { "prompt": "An action shot of a black lab swimming in an inground suburban swimming pool. The camera is placed meticulously on the water line, dividing the image in half,…" } }'
Then paste one of the prompts above: Windsurf finds Nano Banana on Spiral, shows the price and runs it.
Nano Banana providers and prices
Spiral runs Nano Banana through fal. Open a card for today's price, with every fee included.
Settings you can ask for
Nano Banana works from your prompt. Ask Windsurf for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Number of images | 1 to 4 | 1 | The number of images to generate. |
| Seed | a whole number | The seed for the random number generator. | |
| Aspect ratio | 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4 and 2 more | 1:1 | The aspect ratio of the generated image. |
| Output format | jpeg, png, or webp | png | The format of the generated image. |
| Safety tolerance | 1 to 6 | 4 | The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict. |
| Limit generations | on or off | on | Experimental parameter to limit the number of generations from each round of prompting to 1. Set to |
Every API field of Nano Banana · Text to Image is on its tool page: open its card above.
What can you do with Nano Banana in Windsurf?
Create illustrations and visual mockups that fit the project you are building. Use project assets as references, then inspect the results for text errors and unwanted changes.
Product scenes from reference photos
Place an existing product into different settings while asking to preserve its shape, color, and identifying details. Compare each result with the original photo.
Posters with exact wording
Use Pro for artwork that includes a headline or short message. Supply the wording in quotes and describe its position and typography.
Localized campaign artwork
Use Pro Edit to replace text in an existing design with approved translations. Ask to preserve the product, layout, and background.
Sketches turned into mockups
Give Pro Edit a layout sketch and a product reference to create a visual mockup. Assign a specific role to each reference.
Explanatory diagrams
Turn supplied notes into a labeled visual with Pro. Review the relationships and labels against the notes before sharing it.
Photo restyling
Use the editing models to reinterpret a photo as an illustration or change its setting. State which subject details should remain recognizable.
More on Nano Banana and Windsurf
Overview
Nano Banana in other agents
Questions about Nano Banana in Windsurf
Can Windsurf use Nano Banana?
Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run Nano Banana like any built-in tool.
How much does Nano Banana cost in Windsurf?
$0.05174 per image. 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 Nano Banana in Windsurf?
No. Spiral runs Nano Banana on its own fal account. You sign in to Spiral once and never paste a key.
How long does it take to set up Nano Banana in Windsurf?
About two minutes: add the server, then sign in, then check it.
Does Windsurf wait while Nano Banana runs?
Nano Banana runs in the background. Windsurf starts the run, checks on it and gives you the image when it's ready.
When should I choose Nano Banana Pro?
Choose Pro for text-heavy artwork, detailed compositions, or output above the original model's roughly 1K range. It supports native generation from 1K to 4K.
Can Nano Banana keep the same person or product across images?
Maintaining a subject's appearance across edits is a core strength. Use a clear reference and check each result, because consistency is not guaranteed.
Can it create readable text in other languages?
Pro can generate multilingual text and translate existing artwork. Provide the exact translated wording when it matters, then check the rendered spelling before using the image.
How many reference images should I use?
Google says the original works best with up to three input images. Pro supports up to 14 references, but each reference should have a clear purpose, such as the subject, layout, or background.
Can I trust the facts in a generated infographic?
Check every label, number, and relationship against your source material. Pro can misinterpret information or produce incorrect facts even when the graphic looks convincing.
Start using Nano Banana in Windsurf
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Windsurf:
set up https://spiral.ai/SKILL.md


