How to Use GPT Image 1 Mini in Windsurf
Create illustrations, game assets, and image concepts from a written brief. Choose this version when you want a new image; the Edit version starts from reference images.
Prompts to try with GPT Image 1 Mini in Windsurf
Copy an example into Windsurf, or ask in your own words.
Read the project's design brief and use GPT Image 1 Mini to create a 1536 × 1024 editorial illustration for the home page: a bicycle mechanic repairing a wheel, ink and watercolor, with open space on the left for HTML text. Save the PNG in the project's image assets.
Use GPT Image 1 Mini to create a 1024 × 1024 transparent PNG of a copper watering can for this project's gardening game. Match the palette in the design tokens, show the entire object, and include no text.
Read the empty-state copy and use GPT Image 1 Mini to create a 1024 × 1024 illustration of an empty wooden bookshelf with one small plant. Use the project's colors, request a transparent background, and keep all lettering out of the PNG.
Generate a product photo with GPT Image 1 Mini: 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 GPT Image 1 Mini.
How to set up GPT Image 1 Mini 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 GPT Image 1 Mini
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/gpt-image-1-mini", "input": { "prompt": "A serene landscape with mountains reflecting in a crystal-clear lake at sunset, photorealistic style" } }'
Then paste one of the prompts above: Windsurf finds GPT Image 1 Mini on Spiral, shows the price and runs it.
GPT Image 1 Mini providers and prices
Spiral runs GPT Image 1 Mini through fal. Open a card for today's price, with every fee included.
Up to $0.0676 per run at the default inputs. quality: auto (default) $0.0676, low $0.0078, medium $0.0195, high $0.0676. Per unit of num_images: auto (default) $0.0676, low $0.0078, medium $0.0195, high $0.0676.
Settings you can ask for
GPT Image 1 Mini works from your prompt. Ask Windsurf for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Image size | auto, 1024x1024, 1536x1024, or 1024x1536 | auto | Aspect ratio for the generated image |
| Background | auto, transparent, or opaque | auto | Background for the generated image |
| Quality | auto, low, medium, or high | auto | Quality for the generated image |
| Number of images | 1 to 4 | 1 | Number of images to generate |
| Output format | jpeg, png, or webp | png | Output format for the images |
Every API field of GPT Image 1 Mini · Text to Image is on its tool page: open its card above.
What can you do with GPT Image 1 Mini in Windsurf?
Create image assets that fit the project you are building. Have the agent read the design brief, generate artwork at a supported size, and inspect it before adding it to the interface.
Game asset concepts
Try a square inventory illustration of a single object with a transparent background. Review its silhouette at the size it will appear in the game.
Editorial illustrations
Turn an article's main idea into a landscape illustration. Specify the subject and visual medium, and leave space for a headline added separately.
Scene revisions
Use Edit to try a different object color or background in an existing image. State which details should stay, then check for unintended changes.
Portrait artwork
Create a 1024 × 1536 illustration for a cover concept or poster. Keep exact typography as a separate design task.
Visual direction studies
Describe the same subject in watercolor, paper collage, and pencil. Compare the results before choosing a direction for the finished artwork.
Product image variations
Use a product image as an editing reference to explore a different setting. Inspect the product's shape and labels before accepting the result.
More on GPT Image 1 Mini and Windsurf
Overview
GPT Image 1 Mini in other agents
Questions about GPT Image 1 Mini in Windsurf
Can Windsurf use GPT Image 1 Mini?
Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run GPT Image 1 Mini like any built-in tool.
How much does GPT Image 1 Mini cost in Windsurf?
Up to $0.0676 per run at the default inputs. `quality`: auto (default) $0.0676, low $0.0078, medium $0.0195, high $0.0676. $0.0676 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 GPT Image 1 Mini in Windsurf?
No. Spiral runs GPT Image 1 Mini on its own fal account. You sign in to Spiral once and never paste a key.
How long does it take to set up GPT Image 1 Mini in Windsurf?
About two minutes: add the server, then sign in, then check it.
Does Windsurf wait while GPT Image 1 Mini runs?
GPT Image 1 Mini runs in the background. Windsurf starts the run, checks on it and gives you the image when it's ready.
What is the difference between GPT Image 1 Mini and GPT Image 1 Mini Edit?
The generation version creates a new image from a written prompt. Edit uses existing images as references alongside your instructions.
What image sizes can it produce?
Use 1024 × 1024 pixels for square images, 1536 × 1024 for landscape, or 1024 × 1536 for portrait.
Can it make images with transparent backgrounds?
Yes. Request a transparent background and save the result as PNG or WebP.
Can I trust text inside the generated image?
Check every word and its placement before using the image. For artwork that needs exact typography, consider generating the illustration first and adding the text in your design tool.
Will a character look identical across several images?
Separate generations can change a character's appearance or brand details. Try editing an approved reference, then compare each result against it.
Start using GPT Image 1 Mini 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


