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

# How to Use Video Face Swap in Instinct

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, with a Spiral API key |

## Prompts to try with Video Face Swap in Instinct

- Every Monday, use Video Face Swap on the approved 15-second greeting and this week's approved portrait. Queue the result for review.
- Each morning, use Video Face Swap to create previews for newly approved 20-second ads, one result per approved portrait.
- Every Friday, use Video Face Swap on the approved 10-second casting test with each newly approved actor portrait. Keep the results separate.
- Each evening, use Video Face Swap on approved greeting videos shorter than one minute, pairing each with its assigned portrait.
- Every Tuesday, use Video Face Swap to prepare an 8-second head-turn test for each approved video and portrait pair. Queue the tests for visual review.

## How to set up Video Face Swap in Instinct

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

### Use the Spiral skill

1. **Send Instinct 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 Spiral's MCP server

1. **Create an API key**: In the console, open API keys and create a key for Instinct. Copy it.

2. **Send Instinct this message**: Instinct reads Spiral's skill and asks for your API key.

```text
set up https://spiral.ai/SKILL.md
```

3. **Give Instinct the key**: When Instinct asks for the key, add it where Instinct keeps secrets, never in the chat itself.

### 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: Instinct finds Video Face Swap on Spiral, shows the price and runs it.

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

## 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 Instinct?

Prepare recurring face replacement previews from approved footage and portraits. A scheduled agent can organize each result for review before publication.

### 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 Instinct guides](https://spiral.ai/integrations/instinct)

## 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)
- [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)
- [Windsurf](https://spiral.ai/integrations/windsurf/video-face-swap)
- [Zapier](https://spiral.ai/integrations/zapier/video-face-swap)

## More Instinct guides

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

## Questions about Video Face Swap in Instinct

**Can Instinct use Video Face Swap?**

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

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

$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 Instinct plan is separate.

**Do I need a WaveSpeed account to use Video Face Swap in Instinct?**

You need no WaveSpeed account. Instinct uses one Spiral API key for every tool, and Spiral runs Video Face Swap on its own WaveSpeed account.

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

About two minutes: create an API key, then send Instinct this message, then give Instinct the key.

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

Video Face Swap runs in the background. Instinct 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.

