How to Use Ideogram 3.0 Edit in Windsurf
Ideogram 3.0 Edit repaints a masked area of an existing image, useful for replacing an object or revising lettering. Unlike Ideogram 3.0 Remix, it targets a selected region.
Prompts to try with Ideogram 3.0 Edit in Windsurf
Copy an example into Windsurf, or ask in your own words.
Use Ideogram 3.0 Edit on the existing event poster and its matching mask in the project. Replace the masked headline with "OPEN STUDIO" in large block letters. Compare the result with the original before updating the asset.
Remove the background from the photo I attach with Ideogram 3.0 Edit and give me a transparent PNG. Save the result in ./assets.
Use Ideogram 3.0 Edit to clean up these product shots so they sit on pure white.
Edit this image with Ideogram 3.0 Edit: keep the subject, swap the background for a sunlit studio.
Use Ideogram 3.0 Edit to turn this daytime photo into a dusk scene with warm window light.
How to set up Ideogram 3.0 Edit 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 Ideogram 3.0 Edit
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/ideogram/v3/edit", "input": { "prompt": "black bag", "image_url": "https://v3.fal.media/files/panda/-LC_gNNV3wUHaGMQT3klE_output.png", "mask_url": "https://v3.fal.media/files/kangaroo/1dd3zEL5MXQ3Kb4-mRi9d_indir%20(20).png" } }'
Then paste one of the prompts above: Windsurf finds Ideogram 3.0 Edit on Spiral, shows the price and runs it.
Ideogram 3.0 Edit providers and prices
Spiral runs Ideogram 3.0 Edit through fal. Open a card for today's price, with every fee included.
$0.039 per image with TURBO, $0.078 with BALANCED (the default), $0.117 with QUALITY.
Settings you can ask for
Ideogram 3.0 Edit works from your image URLs, prompt, image URL, and mask URL. Ask Windsurf for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Rendering speed | TURBO, BALANCED, or QUALITY | BALANCED | The rendering speed to use. |
| Expand prompt | on or off | on | Determine if MagicPrompt should be used in generating the request or not. |
| Number of images | 1 to 8 | 1 | Number of images to generate. |
| Seed | a whole number | Seed for the random number generator | |
| Style preset | 80S_ILLUSTRATION, 90S_NOSTALGIA, ABSTRACT_ORGANIC, ANALOG_NOSTALGIA, ART_BRUT, ART_DECO, ART_POSTER, AURA and 54 more | Style preset for generation. The chosen style preset will guide the generation. |
Every API field of Ideogram V3 Edit is on its tool page: open its card above.
What can you do with Ideogram 3.0 Edit in Windsurf?
Create graphics and short lettering for the interface you are building with Ideogram 3.0. A coding agent can turn project copy and visual requirements into focused briefs, then place reviewed artwork in the project.
Poster refreshes
Start with an existing poster. Repaint a selected illustration or headline area, or remix the complete design to explore another visual treatment.
Product image concepts
Start with a product image and explore another setting or treatment. Use a mask for a selected region, or remix the image for a broader reinterpretation; compare product details with the original.
Book cover revisions
Use an existing cover to explore a different central illustration, color treatment, or title area. Keep long descriptions and fine print in a separate design tool.
Thumbnail revisions
Rework an existing thumbnail with a simpler focal subject and a short headline. Mask the area to revise, or remix the whole composition for another direction.
More on Ideogram 3.0 Edit and Windsurf
Overview
Ideogram 3.0 Edit in other agents
Questions about Ideogram 3.0 Edit in Windsurf
Can Windsurf use Ideogram 3.0 Edit?
Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run Ideogram 3.0 Edit like any built-in tool.
How much does Ideogram 3.0 Edit cost in Windsurf?
$0.039 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 Ideogram 3.0 Edit in Windsurf?
No. Spiral runs Ideogram 3.0 Edit on its own fal account. You sign in to Spiral once and never paste a key.
How long does it take to set up Ideogram 3.0 Edit in Windsurf?
About two minutes: add the server, then sign in, then check it.
Does Windsurf wait while Ideogram 3.0 Edit runs?
Ideogram 3.0 Edit runs in the background. Windsurf starts the run, checks on it and gives you the image when it's ready.
What is Ideogram 3.0 good at?
Graphics that combine imagery with short, readable lettering are a useful starting point: logo concepts, headlines, badges, and promotional artwork. It also handles realistic imagery.
Can Ideogram 3.0 render exact wording?
Put the exact words in quotation marks and describe their position. Check every result for spelling errors, especially when the text is long or the scene is crowded.
Which languages work best?
English gives the most reliable results, especially for lettering. Accented letters and non-Latin scripts can render incorrectly or disappear.
How long should an Ideogram 3.0 prompt be?
Aim for fewer than about 150 words. Put the main subject and essential wording first, then describe placement, lighting, and style.
When should I turn off Magic Prompt?
Turn it off when your brief already specifies the wording and visual details you want. Leave it on when you want a short idea expanded with additional detail.
Start using Ideogram 3.0 Edit 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


