How to Use Ideogram 3.0 Reframe in Windsurf
Ideogram 3.0 Reframe adapts existing images for banners, social posts, and other layouts by generating space beyond their borders. It keeps the source pixels centered and fills the added area.
Prompts to try with Ideogram 3.0 Reframe in Windsurf
Copy an example into Windsurf, or ask in your own words.
Use Ideogram 3.0 Reframe to expand the homepage artwork into a landscape banner. Preview it in the existing hero component and check the generated borders.
Find the newsletter header image in this project and use Ideogram 3.0 Reframe to make a 1280 by 720 version. Save it beside the original.
Use Ideogram 3.0 Reframe to create square compositions from the existing article illustrations. Build a local comparison page showing each source and result.
Use Ideogram 3.0 Reframe to expand the onboarding illustration into a portrait composition. Preview it in the mobile layout before changing the image reference.
Use Ideogram 3.0 Reframe to prepare landscape versions of the campaign artwork. Compare faster and higher quality renders in a local preview.
How to set up Ideogram 3.0 Reframe 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 Reframe
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/reframe", "input": { "image_url": "https://v3.fal.media/files/lion/0qJs_qW8nz0wYsXhFa6Tk.png", "image_size": "square_hd" } }'
Then paste one of the prompts above: Windsurf finds Ideogram 3.0 Reframe on Spiral, shows the price and runs it.
Ideogram 3.0 Reframe providers and prices
Spiral runs Ideogram 3.0 Reframe 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 Reframe works from your image URLs and image 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. |
| Style | AUTO, GENERAL, REALISTIC, or DESIGN | The style type to generate with. Cannot be used with style_codes. | |
| 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 · Reframe is on its tool page: open its card above.
What can you do with Ideogram 3.0 Reframe in Windsurf?
Adapt existing project artwork to the layouts your application needs. A coding agent can inspect image placements, request expanded compositions, and preview the results in context.
Website banners
Expand an existing campaign image into a wide composition for a website banner, then check the added edges in the page layout.
Social post adaptations
Reframe approved artwork for square, landscape, and portrait placements while retaining the central content.
Newsletter headers
Extend a selected editorial image into a landscape header instead of cutting away its central subject.
Presentation artwork
Expand an existing illustration for a slide background, then place slide titles separately.
Product campaign layouts
Add surrounding image area to an existing product visual for different campaign placements. Review the generated surroundings before approval.
Article thumbnail preparation
Adapt an article's selected image to a landscape thumbnail and compare the result with the original composition.
More on Ideogram 3.0 Reframe and Windsurf
Overview
Ideogram 3.0 Reframe in other agents
Questions about Ideogram 3.0 Reframe in Windsurf
Can Windsurf use Ideogram 3.0 Reframe?
Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run Ideogram 3.0 Reframe like any built-in tool.
How much does Ideogram 3.0 Reframe 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 Reframe in Windsurf?
No. Spiral runs Ideogram 3.0 Reframe 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 Reframe in Windsurf?
About two minutes: add the server, then sign in, then check it.
Does Windsurf wait while Ideogram 3.0 Reframe runs?
Ideogram 3.0 Reframe 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 Reframe good for?
Use it to adapt an existing visual to a different layout, such as a banner or social post. It generates additional image area around the centered source.
Does Ideogram 3.0 Reframe crop or stretch the original?
Its documented operation keeps the source pixels in the center and fills the new area. Choose it when you want to expand the composition around existing content.
What output size can I request?
The documentation includes a custom size example of 1280 by 720 pixels. Specify both width and height when the destination needs exact dimensions.
How should I describe a reframing request?
Identify the source image, the destination layout, and the desired dimensions or orientation. Ask your agent to compare the added borders with the original before selecting a result.
Can Ideogram 3.0 Reframe fix lettering or remove an object?
Use a separate editing operation for those changes. Ideogram directs text corrections to editable text layers and object removal to Object Remover.
Start using Ideogram 3.0 Reframe 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


