Spiral gives your agent every tool with one account. Browse the tools →

Windsurf · ImageReleased 2026-04-20

How to Use GPT Image 2 in Windsurf

Use GPT Image 2 to create posters, diagrams, and realistic images from a written brief. Choose it when you are starting from text; choose GPT Image 2 Edit when an existing image is the starting point.

Prompts to try with GPT Image 2 in Windsurf

Copy an example into Windsurf, or ask in your own words.

Use GPT Image 2 to create a 1536×1024 illustration for the article in this project. Read its main argument first, depict one concrete scene, and leave the left third clear for the existing headline. Use medium quality.

GPT Image 2Windsurf
Try asking
  • Use GPT Image 2 to turn this project's onboarding documentation into a 1536×1024 diagram. Use the documented steps and exact labels, with a clear reading order. Choose high quality and check the rendered wording against the source.

  • Use GPT Image 2 to create three 1536×1024 cover concepts for the project's release announcement. Base each on the actual release notes, use low quality, and omit lettering so the page can supply its own headline.

  • Generate a product photo with GPT Image 2: 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 2.

How to set up GPT Image 2 in Windsurf

Pick the way that suits you. Each takes about two minutes.

Use Spiral's MCP server

  1. 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"
        }
      }
    }
  2. 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
  3. Check it

    Spiral is listed under This computer in Customize › MCPs. From the terminal:

    devin mcp list

Use the Spiral skill

  1. Send Windsurf this message

    Your agent reads Spiral's skill and sets itself up.

    set up https://spiral.ai/SKILL.md
  2. Sign in or paste a key

    Approve Spiral in the browser, or give the agent a key from the console.

Use the Spiral CLI

  1. 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

  1. Create an API key

    In the console, under API keys.

  2. Run GPT Image 2

    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": "openai/gpt-image-2",
        "input": {
          "prompt": "create a realistic image taken with iphone at these coordinates 41°43′32″N 49°56′49″W 15 April 1912"
        }
      }'

Then paste one of the prompts above: Windsurf finds GPT Image 2 on Spiral, shows the price and runs it.

GPT Image 2 providers and prices

Spiral runs GPT Image 2 through fal and OpenAI. Open a card for today's price, with every fee included. Name one in your prompt, or let Windsurf pick.

falImage
OpenAIDeprecatedImage

Settings you can ask for

GPT Image 2 works from your prompt. Ask Windsurf for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Backgroundauto or opaqueauto

Background for the generated image

Qualityauto, low, medium, or highhigh

Quality for the generated image. Use 'auto' to let the model pick the best quality for the prompt.

Number of images1 to 101

Number of images to generate

Output formatjpeg, png, or webppng

Output format for the images

Output compression0 to 100

Compression level from 0 to 100. Only supported when output_format is 'jpeg' or 'webp'.

Image passthroughon or offoff

Send reference images and masks without resizing or re-encoding, and return the provider's original image bytes and format. Requests use the direct OpenAI API. Masks must be PNGs with an alpha channel: transparent regions are edited, and dimensions must match the first reference.

Every API field of GPT Image 2 · Text to Image is on its tool page: open its card above.

What can you do with GPT Image 2 in Windsurf?

Create image assets that fit the project's actual content and layout. A coding agent can use repository briefs and existing images to prepare illustrations, diagrams, and targeted revisions.

Article illustrations

Turn an article brief into a realistic scene or explanatory illustration, with space reserved for a headline.

Labeled diagrams

Create an infographic from supplied relationships and exact labels, then review the text and arrangement.

Product scene revisions

Edit a product photograph into a different setting while specifying which shape, label, and lighting details to preserve.

Visual sequences

Describe each panel of a short visual story and review the result for subject continuity.

Campaign concepts

Explore poster compositions at low quality, then refine a chosen direction with exact copy at higher quality.

Reference composites

Combine a subject from one image with a scene from another, naming each reference's role.

GPT Image 2 success rate and speed on Spiral

Success and speed over the last 24 hours, across every run of these tools on Spiral.

Success rate
100.0%
Fastest median run time
1m 10s
Runs, last 24 hours
136
ToolSuccessMedian timeRuns
GPT Image 2 · Text to Image100.0%1m 10s136
GPT Image 2 · Text to ImageNot enough runs

Questions about GPT Image 2 in Windsurf

Can Windsurf use GPT Image 2?

Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run GPT Image 2 like any built-in tool.

How much does GPT Image 2 cost in Windsurf?

$0.188 per 4:3 image at high quality ($0.00559 low, $0.0473 medium). At high: $0.24 square, $0.274 square HD, $0.135 16:9. Auto quality or size: the price of the one chosen for the request. Prompt: $6.50 per 1M tokens. 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 2 in Windsurf?

No. Spiral runs GPT Image 2 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 2 in Windsurf?

About two minutes: add the server, then sign in, then check it.

Which provider runs GPT Image 2?

Spiral offers GPT Image 2 through fal and OpenAI. Name one in your prompt, or let Windsurf pick.

Does Windsurf wait while GPT Image 2 runs?

GPT Image 2 runs in the background. Windsurf starts the run, checks on it and gives you the image when it's ready.

What is GPT Image 2 good at?

It is useful for realistic imagery, posters with embedded text, infographics, diagrams, and visual sequences. Give it a concrete brief with the subject, composition, required copy, and intended use.

How does GPT Image 2 Edit differ from GPT Image 2?

Both use the same underlying model. Choose the generation entry to start from a written brief and the editing entry to revise existing imagery or combine references.

Can GPT Image 2 generate 4K images?

Yes. Supported examples include 3840×2160 landscape and 2160×3840 portrait; custom sizes must meet the dimension, aspect ratio, and total pixel limits.

How do I get readable text inside an image?

Quote the exact copy, specify its position and typography, and say how many times it should appear. Check the result for spelling and placement before using it.

Which quality setting should I use?

Start with low quality to compare draft concepts. Use medium or high for final assets, especially when small lettering or dense labels matter.

Get started

Start using GPT Image 2 in Windsurf

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Windsurf:

Set up Windsurf

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options