[Integrations](https://spiral.ai/integrations) › [Windsurf](https://spiral.ai/integrations/windsurf) › [Wan 2.7 Pro Edit](https://spiral.ai/integrations/windsurf/wan-2-7-pro-edit)

# How to Use Wan 2.7 Pro Edit in Windsurf

Wan 2.7 Pro Edit revises existing images for tasks such as product retouching and composition changes. Compared with Wan 2.7 Image to Image, Alibaba positions Pro for more stable composition and closer prompt interpretation.

|  |  |
| --- | --- |
| Model | Wan 2.7 Pro Edit |
| Available through | fal |
| Category | Image |
| Price | $0.0975 per image. Billed on `num_images`, default 1. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Wan 2.7 Pro Edit in Windsurf

- Use Wan 2.7 Pro Edit to update the date on the event poster in this project's assets to October 12. Preserve the illustration and all other wording; return one 2048 × 2048 image.
- Use Wan 2.7 Pro Edit to revise the product photo in this project's assets: replace the background with a matte gray tabletop, preserve the object's shape and label, and return one 1024 × 1024 image.
- Remove the background from the photo I attach with Wan 2.7 Pro Edit and give me a transparent PNG. Save the result in ./assets.
- Use Wan 2.7 Pro Edit to clean up these product shots so they sit on pure white.
- Edit this image with Wan 2.7 Pro Edit: keep the subject, swap the background for a sunlit studio.

## How to set up Wan 2.7 Pro Edit 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:

```json
{
  "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.

```bash
devin mcp login spiral
```

3. **Check it**: Spiral is listed under This computer in Customize › MCPs. From the terminal:

```bash
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.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Wan 2.7 Pro Edit**: One request; the result comes back by polling or a webhook.

```bash
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/wan/v2.7/pro/edit",
    "input": {
      "prompt": "Turn image 1 into a watercolor painting.",
      "image_urls": [
        "<image_urls>"
      ]
    }
  }'
```

Then paste one of the prompts above: Windsurf finds Wan 2.7 Pro Edit on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/windsurf

## Wan 2.7 Pro Edit tools and prices

- [Wan 2.7 Pro Edit · Image to Image](https://spiral.ai/tools/fal/fal-ai/wan/v2.7/pro/edit) (fal): $0.0975 per image. Billed on `num_images`, default 1.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| negative_prompt |  |  | Content to avoid in the generated image. Max 500 characters. |
| image_size |  | square_hd | Output image size. Uses fal image size presets or explicit dimensions and is converted to DashScope size format. |
| num_images | 1 to 4 | 1 | Number of images to generate (1-4). |
| enable_prompt_expansion |  | true | Enable DashScope prompt expansion. Supported only for image edit mode. |
| seed |  | — | Random seed for reproducibility (0-2147483647). |
| output_format | jpeg, png, webp | jpeg | The format of the generated images. |

## What can you do with Wan 2.7 Pro Edit in Windsurf?

Turn a project's visual requirements into images that fit its screens and content. Use Wan 2.7 Image for text-bearing graphics and detailed compositions, then inspect the results in the actual layout.

### Product background revisions

Revise a supplied product photo with a different setting, lighting treatment, or surrounding props while asking to preserve the product's appearance.

### Portrait style studies

Turn a supplied portrait into a pencil drawing or watercolor study, with explicit instructions about which facial features to preserve.

### Poster text revisions

Update a headline or date in a supplied graphic while asking to keep its layout, illustration, and remaining wording.

### Reference-based compositions

Combine elements from supplied images into a composition, identifying which image supplies each subject, background, or visual treatment.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Windsurf guides](https://spiral.ai/integrations/windsurf)

## Wan 2.7 Pro Edit in other agents

- [Amp](https://spiral.ai/integrations/amp/wan-2-7-pro-edit)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/wan-2-7-pro-edit)
- [Claude](https://spiral.ai/integrations/claude-desktop/wan-2-7-pro-edit)
- [Claude Code](https://spiral.ai/integrations/claude-code/wan-2-7-pro-edit)
- [Cline](https://spiral.ai/integrations/cline/wan-2-7-pro-edit)
- [Codex](https://spiral.ai/integrations/codex/wan-2-7-pro-edit)
- [Cursor](https://spiral.ai/integrations/cursor/wan-2-7-pro-edit)
- [Devin](https://spiral.ai/integrations/devin/wan-2-7-pro-edit)
- [dots](https://spiral.ai/integrations/dots/wan-2-7-pro-edit)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/wan-2-7-pro-edit)
- [Gemini](https://spiral.ai/integrations/gemini/wan-2-7-pro-edit)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/wan-2-7-pro-edit)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/wan-2-7-pro-edit)
- [goose](https://spiral.ai/integrations/goose/wan-2-7-pro-edit)
- [Grok](https://spiral.ai/integrations/grok/wan-2-7-pro-edit)
- [Grok Build](https://spiral.ai/integrations/grok-build/wan-2-7-pro-edit)
- [Hermes](https://spiral.ai/integrations/hermes/wan-2-7-pro-edit)
- [Instinct](https://spiral.ai/integrations/instinct/wan-2-7-pro-edit)
- [Manus](https://spiral.ai/integrations/manus/wan-2-7-pro-edit)
- [Muse](https://spiral.ai/integrations/muse/wan-2-7-pro-edit)
- [Muse Code](https://spiral.ai/integrations/muse-code/wan-2-7-pro-edit)
- [n8n](https://spiral.ai/integrations/n8n/wan-2-7-pro-edit)
- [Notion](https://spiral.ai/integrations/notion/wan-2-7-pro-edit)
- [OpenClaw](https://spiral.ai/integrations/openclaw/wan-2-7-pro-edit)
- [opencode](https://spiral.ai/integrations/opencode/wan-2-7-pro-edit)
- [Perplexity](https://spiral.ai/integrations/perplexity/wan-2-7-pro-edit)
- [Raycast](https://spiral.ai/integrations/raycast/wan-2-7-pro-edit)
- [VS Code](https://spiral.ai/integrations/vscode/wan-2-7-pro-edit)
- [Zapier](https://spiral.ai/integrations/zapier/wan-2-7-pro-edit)

## More Windsurf guides

- [Wan 2.7 Image to Image](https://spiral.ai/integrations/windsurf/wan-2-7-image-to-image)
- [Wan 2.7 Pro Text to Image](https://spiral.ai/integrations/windsurf/wan-2-7-pro-text-to-image)
- [Wan 2.6 Text to Image](https://spiral.ai/integrations/windsurf/wan-2-6-text-to-image)
- [Wan 2.7 Text to Image](https://spiral.ai/integrations/windsurf/wan-2-7-text-to-image)
- [Wan 2.6 Image to Image](https://spiral.ai/integrations/windsurf/wan-2-6-image-to-image)
- [Weather Effect](https://spiral.ai/integrations/windsurf/weather-effect)

## Questions about Wan 2.7 Pro Edit in Windsurf

**Can Windsurf use Wan 2.7 Pro Edit?**

Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run Wan 2.7 Pro Edit like any built-in tool.

**How much does Wan 2.7 Pro Edit cost in Windsurf?**

$0.0975 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 Wan 2.7 Pro Edit in Windsurf?**

No. Spiral runs Wan 2.7 Pro 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 Wan 2.7 Pro Edit in Windsurf?**

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

**Does Windsurf wait while Wan 2.7 Pro Edit runs?**

Wan 2.7 Pro Edit runs in the background. Windsurf starts the run, checks on it and gives you the image when it's ready.

**What is Wan 2.7 Image useful for?**

Wan 2.7 Image is useful for posters, illustrated content, and visual work that combines readable text with a specified composition. Alibaba highlights text rendering, subject consistency, and complex instruction following.

**Can Wan 2.7 Image put text inside a picture?**

Yes. Text rendering is one of its documented strengths, making it useful for poster headlines, labels, and illustrated explainers. Give the exact wording and check the result before publishing.

**Does Wan 2.7 Image support multilingual text?**

Alibaba reports text rendering in 12 languages. For a localized graphic, supply the approved wording rather than asking the image model to translate it.

**How should I describe the picture I want?**

Specify the subject, setting, style, lighting, and composition. For example, describe a ceramic mug photographed from above on a wooden table in morning window light, rather than asking for a nice product picture.

**Can Wan 2.7 Image make a 2048 × 2048 image?**

Yes. A square image at 2048 × 2048 fits the documented 2K output limit shared across these models.

