How to Use Ideogram 4.5 Edit in Windsurf
Revise product photos, signs, and layouts while keeping details you want to preserve. Unlike Ideogram 4.5 Text to Image, it works from an existing image; high precision restores pixels outside meaningful changes.
Prompts to try with Ideogram 4.5 Edit in Windsurf
Copy an example into Windsurf, or ask in your own words.
Use Ideogram 4.5 Edit on the existing announcement image in the project's assets. Change only the headline to "Now available" and preserve the illustration, layout, and colors. Use high precision.
Use Ideogram 4.5 Edit on the product image in the project's assets. Change the product's finish to brushed steel while preserving its shape, position, and background. Save the result separately for comparison.
Remove the background from the photo I attach with Ideogram 4.5 Edit and give me a transparent PNG. Save the result in ./assets.
Use Ideogram 4.5 Edit to clean up these product shots so they sit on pure white.
Edit this image with Ideogram 4.5 Edit: keep the subject, swap the background for a sunlit studio.
How to set up Ideogram 4.5 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 4.5 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": "ideogram/v4.5/edit", "input": { "prompt": "A colorful storefront with a sign reading hello", "image_url": "<image_url>" } }'
Then paste one of the prompts above: Windsurf finds Ideogram 4.5 Edit on Spiral, shows the price and runs it.
Ideogram 4.5 Edit providers and prices
Spiral runs Ideogram 4.5 Edit through fal. Open a card for today's price, with every fee included.
$0.078 per run at the default inputs. quality: very_low $0.0104, low $0.039, medium (default) $0.078, high $0.286. Per unit of num_images: very_low $0.0104, low $0.039, medium (default) $0.078, high $0.286.
Settings you can ask for
Ideogram 4.5 Edit works from your prompt, image URL, reference image URLs, and mask URL. Ask Windsurf for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Edit precision | regular or high | regular | regular uses Generate; high uses Precise Edit with unchanged-pixel restoration. Both always prepare structured edit instructions. |
| Quality | very_low, low, medium, or high | medium | Quality tier for either edit precision. Defaults to medium. |
| Number of images | 1 to 8 | 1 | Number of images to generate. |
| Seed | a whole number | Random seed. Omit to choose automatically. |
Every API field of Ideogram 4.5 Edit is on its tool page: open its card above.
What can you do with Ideogram 4.5 Edit in Windsurf?
Turn project copy into posters, thumbnails, and other graphics with short visible text. A coding agent can use the project's wording and design references to prepare prompts and check generated lettering.
Event posters
Create a poster from an event brief, or revise an existing poster's headline. Keep the event name short and check every date before publishing.
YouTube thumbnails
Create a thumbnail around a short title, or update the wording on an existing design. Give the headline a clear position and keep the scene simple.
Logo concepts
Explore a brand name with a simple symbol, or refine an existing logo image. Specify the exact name, lettering style, and colors.
Book cover concepts
Develop a cover around a title and illustration, or revise an existing cover's wording. Keep long descriptions and back-cover copy for a design tool.
Product photo revisions
Start with a product photo and explore a different color, finish, or setting. Compare the result with the original to check shape and product details.
Interior finish previews
Use a room photo to compare upholstery, materials, or lighting. Change one detail at a time and ask to preserve the room's layout.
Old photo repairs
Start with a scanned photo and request scratch removal, stain repair, or restored color. Inspect faces and small details against the original.
More on Ideogram 4.5 Edit and Windsurf
Overview
Ideogram 4.5 Edit in other agents
Questions about Ideogram 4.5 Edit in Windsurf
Can Windsurf use Ideogram 4.5 Edit?
Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run Ideogram 4.5 Edit like any built-in tool.
How much does Ideogram 4.5 Edit cost in Windsurf?
$0.078 per run at the default inputs. `quality`: very_low $0.0104, low $0.039, medium (default) $0.078, high $0.286. $0.078 per unit of `num_images`. 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 4.5 Edit in Windsurf?
No. Spiral runs Ideogram 4.5 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 4.5 Edit in Windsurf?
About two minutes: add the server, then sign in, then check it.
Does Windsurf wait while Ideogram 4.5 Edit runs?
Ideogram 4.5 Edit runs in the background. Windsurf starts the run, checks on it and gives you the image when it's ready.
What is Ideogram 4.5 good at?
Posters, logos, and graphics that combine images with short text are useful starting points. Give the wording and composition equal attention in your prompt.
Can Ideogram 4.5 write long passages inside an image?
Short phrases work best. Longer text increases the chance of a typo or missing letter, so add substantial body copy in a design tool.
Which language works best with Ideogram 4.5?
English is the most reliable, especially for visible text. Review other languages with someone fluent before publishing.
How should I specify exact wording?
Put the words in quotation marks with the spelling and capitalization you want. Describe where the text belongs and how the lettering should look.
When should I use high quality?
Use it when fine detail matters more than generation speed. Compare the lettering and small visual details against a medium-quality draft before choosing the final image.
Start using Ideogram 4.5 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


