[Integrations](https://spiral.ai/integrations) › [Windsurf](https://spiral.ai/integrations/windsurf) › [Video Face Swap](https://spiral.ai/integrations/windsurf/video-face-swap)

# How to Use Video Face Swap in Windsurf

Video Face Swap replaces a person's face in existing footage using a reference portrait while retaining the original expressions and lip movements. It suits talking clips and face replacement edits; hair and head outline generally stay as filmed.

|  |  |
| --- | --- |
| Model | Video Face Swap |
| Available through | WaveSpeed |
| Category | Video |
| Price | $0.013 per second, at least 3 seconds. |
| Returns | video |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Video Face Swap in Windsurf

- Use Video Face Swap on the project's 15-second presenter clip with the approved portrait. Save a separate preview.
- Create three casting previews with Video Face Swap using the project's 20-second ad and three approved portraits, one request per portrait.
- Use Video Face Swap on a 10-second excerpt containing the sharpest head turn in the project's footage. Save it for review.
- Process the project's 30-second greeting with Video Face Swap and the approved participant portrait. Keep the original alongside the result.
- Use Video Face Swap to test the project's two approved portraits on the same 12-second performance. Build a comparison page with both results.

## How to set up Video Face Swap 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 Video Face Swap**: 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": "wavespeed",
    "model": "wavespeed-ai/video-face-swap",
    "input": {
      "video": "<video>",
      "face_image": "<face_image>"
    }
  }'
```

Then paste one of the prompts above: Windsurf finds Video Face Swap on Spiral, shows the price and runs it.

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

## Video Face Swap tools and prices

- [Video Face Swap](https://spiral.ai/tools/wavespeed/wavespeed-ai/video-face-swap) (WaveSpeed): $0.013 per second, at least 3 seconds.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| target_index | 0 to 10 | 0 | 0 = largest face. To switch to another target face - switch to index 1, e.t.c. |
| target_gender | all, male, female | all | Only swap target faces matching this gender. 'all' swaps regardless of gender. |

## What can you do with Video Face Swap in Windsurf?

Create face replacement previews from footage already in your project. Your coding agent can prepare short tests and organize results for review.

### Presenter face replacement

Use an approved portrait to replace the face in a recorded introduction while retaining the presenter's facial performance.

### Ad casting previews

Compare approved faces in the same filmed ad before deciding which appearance fits the creative.

### Short-film casting tests

Preview an actor's face on an existing performance to assess the shot, with the original hair and head outline generally retained.

### Personalized greeting clips

Place a participant's approved portrait into a prerecorded greeting, producing one face replacement per request.

### Comedy sketches

Replace a performer's face in an original sketch while keeping the facial expressions that carry the joke.

### Reference portrait comparisons

Process the same short shot with several approved portraits in separate requests, then compare identity match and facial edges.

## Overview

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

## Video Face Swap in other agents

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

## More Windsurf guides

- [Video Eraser Mask Video to Video](https://spiral.ai/integrations/windsurf/video-eraser-mask-video-to-video)
- [Video Upscaler Pro](https://spiral.ai/integrations/windsurf/video-upscaler-pro)
- [Video Eraser Keypoints Video to Video](https://spiral.ai/integrations/windsurf/video-eraser-keypoints-video-to-video)
- [Vidu Image to Video](https://spiral.ai/integrations/windsurf/vidu-image-to-video)
- [VOID Video Inpainting](https://spiral.ai/integrations/windsurf/void-video-inpainting)
- [Vidu Q1 Image to Video](https://spiral.ai/integrations/windsurf/vidu-q1-image-to-video)

## Questions about Video Face Swap in Windsurf

**Can Windsurf use Video Face Swap?**

Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run Video Face Swap like any built-in tool.

**How much does Video Face Swap cost in Windsurf?**

$0.013 per second, at least 3 seconds. 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 WaveSpeed account to use Video Face Swap in Windsurf?**

No. Spiral runs Video Face Swap on its own WaveSpeed account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Video Face Swap in Windsurf?**

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

**Does Windsurf wait while Video Face Swap runs?**

Video Face Swap runs in the background. Windsurf starts the run, checks on it and gives you the video when it's ready.

**How long can a Video Face Swap clip be?**

The source video can be up to 10 minutes long.

**Does Video Face Swap keep the original performance?**

It is designed to retain the original facial movements, emotions, and lip sync while replacing the face. Review the result before using it.

**What reference photo works best?**

Choose a clear, front-facing portrait with good lighting and an unobstructed face. Avoid sunglasses and strong shadows.

**Can I replace two people with different faces?**

Yes, through separate requests. Each request uses one reference identity to replace one selected face.

**Will Video Face Swap also replace the hairstyle?**

Hair and head outline generally remain from the original footage. Face replacement works best when you want to retain those parts of the shot.

