Video Face Swap
wavespeed-ai/video-face-swapEdit and transform video with Video Face Swap from WaveSpeed through one Spiral API key. Swaps a real human face in a video for a reference face; animal, cartoon, profile or very small faces may come back unchanged. It runs in the background and returns video. Pay as you go, with no subscription.
Pricing
$0.013 per second, at least 3 seconds.
Limits
- Runs
- In the background
- Returns
- video
- Longest queue wait
- 1 hour
- Run deadline
- 30 minutes
- Longest run, end to end
- 810 minutes
- Largest inline input
- 1 MB
- Largest input file
- 2 GB
- Largest output
- 5 GB
Input
| Field | Kind | Default | Description |
|---|---|---|---|
video required | URL or file | — | The video that contains the face to be replaced. |
face_image required | URL or file | — | The face image as reference. |
target_index | number (whole) 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 | one of all, male, female | all | Only swap target faces matching this gender. 'all' swaps regardless of gender. |
Same request in code
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>"
}
}'Frequently asked questions
How much does Video Face Swap cost?
$0.013 per second, at least 3 seconds. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.
How do I use Video Face Swap through an API?
Send `POST /v1/runs` with `"provider": "wavespeed"`, `"model": "wavespeed-ai/video-face-swap"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.
Do I need an account with WaveSpeed to use Video Face Swap?
No. Spiral runs it on its own WaveSpeed account and charges your Spiral balance.
Can my AI agent use Video Face Swap?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.