[Integrations](https://spiral.ai/integrations) › [Windsurf](https://spiral.ai/integrations/windsurf) › [VEED Lipsync](https://spiral.ai/integrations/windsurf/veed-lipsync)

# How to Use VEED Lipsync in Windsurf

VEED Lipsync matches a speaker's mouth movements to replacement audio in existing footage. Use it to fix dialogue or make translated versions of a talking video without recording the picture again.

|  |  |
| --- | --- |
| Model | VEED Lipsync |
| Available through | fal |
| Category | Video |
| Price | Up to $0.52 per run at the default inputs for 60 seconds of input. |
| Returns | video |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with VEED Lipsync in Windsurf

- Use VEED Lipsync to update the presenter clip in public/media/onboarding.mp4 with public/media/onboarding-corrected.wav. Check that the durations match first, then save a separate review copy.
- Use VEED Lipsync to make a Spanish edition of assets/training-intro.mp4 with assets/training-intro-es.wav. Compare their durations before processing and leave the original assets intact.
- Find the front-facing presenter take with the least head movement in assets/presenter-takes. Use VEED Lipsync with assets/approved-dialogue.wav after checking the selected pair's durations.
- Use VEED Lipsync to create separate review clips for each approved opening recording in assets/ad-hooks, paired with assets/ad-presenter.mp4. Flag duration mismatches before processing.
- Use VEED Lipsync to replace the outdated spoken line in assets/product-intro.mp4 with assets/product-intro-new.wav. Save the result beside the source and add it to the project's video review page.

## How to set up VEED Lipsync 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 VEED Lipsync**: 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": "veed/lipsync",
    "input": {
      "video_url": "https://v3.fal.media/files/monkey/q1fDPhrpfjfsaRmbhTed4_influencer.mp4",
      "audio_url": "https://v3.fal.media/files/rabbit/Ql3ade3wEKlZXRQLRbhxm_tts.mp3"
    }
  }'
```

Then paste one of the prompts above: Windsurf finds VEED Lipsync on Spiral, shows the price and runs it.

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

## VEED Lipsync tools and prices

- [Lipsync](https://spiral.ai/tools/fal/veed/lipsync) (fal): $0.52 per minute.

## What can you do with VEED Lipsync in Windsurf?

Turn existing presenter footage into corrected or localized video assets for your project. Use VEED Lipsync for the mouth synchronization, and have the coding agent organize source pairs and review copies.

### Correct a presenter’s line

Match an existing presenter shot to a corrected recording when a product name or spoken detail changes.

### Localize a product ad

Pair a filmed spokesperson with an approved translated recording to prepare an ad for another market.

### Translate employee training

Reuse instructor footage with translated speech recordings for employees who speak different languages.

### Replace dialogue in post-production

Fit a replacement dialogue recording to an existing shot after the picture has been edited.

### Refresh an onboarding lesson

Update a presenter’s spoken instructions with a revised recording when a process changes.

### Test alternate ad openings

Make separate versions of a presenter clip using approved opening-line recordings, each matched to the selected shot’s duration.

## Overview

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

## VEED Lipsync in other agents

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

## More Windsurf guides

- [VEED Fabric 1.0](https://spiral.ai/integrations/windsurf/veed-fabric-1-0)
- [VEED Subtitles](https://spiral.ai/integrations/windsurf/veed-subtitles)
- [VEED Dubbing Standard](https://spiral.ai/integrations/windsurf/veed-dubbing-standard)
- [VEED Video Background Removal](https://spiral.ai/integrations/windsurf/veed-video-background-removal)
- [VEED Dubbing Pro](https://spiral.ai/integrations/windsurf/veed-dubbing-pro)
- [VEED Video Background Removal Fast](https://spiral.ai/integrations/windsurf/veed-video-background-removal-fast)

## Questions about VEED Lipsync in Windsurf

**Can Windsurf use VEED Lipsync?**

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

**How much does VEED Lipsync cost in Windsurf?**

Up to $0.52 per run at the default inputs for 60 seconds of input. 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 VEED Lipsync in Windsurf?**

No. Spiral runs VEED Lipsync on its own fal account. You sign in to Spiral once and never paste a key.

**How long does it take to set up VEED Lipsync in Windsurf?**

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

**Does Windsurf wait while VEED Lipsync runs?**

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

**What is VEED Lipsync useful for?**

Use it when the footage is usable but the spoken line needs to change. It can match the speaker's lips to replacement dialogue, including a translated recording.

**Can VEED Lipsync help localize training videos?**

Yes. Pair the existing presenter footage with a translated speech recording to make another language version of the lesson.

**What footage gives the best results?**

Choose a front-facing shot with little head movement. Prefer that over a take where the speaker keeps turning away.

**How should I prepare replacement dialogue?**

Match the replacement recording's duration to the video segment you want to change. Review the timing before submitting the pair.

**Is VEED Lipsync the same as Lipsync 2.0?**

No. VEED identifies the original Lipsync and Lipsync 2.0 separately, so use documentation that names the version you are working with.

