Spiral gives your agent every tool with one account. Browse the tools →

WaveSpeedVideoAvailable nowReleased 2025-09-02

Video Face Swap

wavespeed-ai/video-face-swap

Edit 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

FieldKindDefaultDescription
video requiredURL or file—

The video that contains the face to be replaced.

face_image requiredURL or file—

The face image as reference.

target_indexnumber (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_genderone 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.