How to Use Video Face Swap in Grok
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.
Prompts to try with Video Face Swap in Grok
Copy an example into Grok, or ask in your own words.
Use Video Face Swap with this 15-second introduction and my portrait. Replace the presenter's face.
Make a casting preview with Video Face Swap using this 20-second scene and the approved actor portrait.
Use Video Face Swap to place my face in this 10-second greeting that I filmed.
Compare these two approved portraits in this 12-second ad using Video Face Swap. Make a separate result for each portrait.
Use Video Face Swap on this 8-second head-turn shot with the approved portrait so I can review the difficult moment first.
How to set up Video Face Swap in Grok
Pick the way that suits you. Each takes about two minutes.
Use the Grok connector
- Add a custom connector
In Grok open Settings › Connect Apps, then Add a custom connector. Name it Spiral, paste this URL, leave Headers empty and click Add MCP.
https://api.spiral.ai/mcp
- Sign in to Spiral and approve
Grok opens Spiral: sign in, pick the organization and click Authorize. Spiral gives the connection its own API key; Grok never sees it, and you can remove the connection under Settings › Connected apps.
- Check that it is connected
Connect Apps › Custom shows Spiral as Connected. It works in every Grok chat and Grok bot.
Use the Spiral skill
- Send Grok this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- 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
- Create an API key
In the console, under API keys.
- Run Video Face Swap
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": "wavespeed", "model": "wavespeed-ai/video-face-swap", "input": { "video": "<video>", "face_image": "<face_image>" } }'
Then paste one of the prompts above: Grok finds Video Face Swap on Spiral, shows the price and runs it.
Video Face Swap providers and prices
Spiral runs Video Face Swap through WaveSpeed. Open a card for today's price, with every fee included.
Settings you can ask for
Video Face Swap works from your video and face image. Ask Grok for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Target index | 0 to 10 | 0 | 0 = the largest face the detector finds, 1 the next, and so on. Profile and very small faces may not be found, and the video comes back unchanged. |
| Target gender | all, male, or female | all | Only swap target faces matching this gender. 'all' swaps regardless of gender. |
Every API field of Video Face Swap is on its tool page: open its card above.
What can you do with Video Face Swap in Grok?
Make casting previews and personalized clips from a video and an approved portrait. A chat agent can help choose a clear reference and prepare a short test 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.
More on Video Face Swap and Grok
Overview
Video Face Swap in other agents
Questions about Video Face Swap in Grok
Can Grok use Video Face Swap?
Yes. Add Spiral to Grok as an MCP server, and Grok can find and run Video Face Swap like any built-in tool.
How much does Video Face Swap cost in Grok?
$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 Grok plan is separate.
Do I need a WaveSpeed account to use Video Face Swap in Grok?
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 Grok?
About two minutes: add a custom connector, then sign in to Spiral and approve, then check that it is connected.
Does Grok wait while Video Face Swap runs?
Video Face Swap runs in the background. Grok 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.
Start using Video Face Swap in Grok
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Grok:
set up https://spiral.ai/SKILL.md


