WaveSpeed AI Video Face Swap | AI Portrait Transfer API

Video Face Swap

Seamlessly swap faces in videos with just a few clicks. Upload your video and a reference face image, and the model will intelligently replace faces while preserving natural motion, lighting, and expressions. No complex editing software required.

Why It Looks Great

Natural blending: Automatically matches skin tone, lighting, and shadows for seamless face integration.
Expression preservation: Retains the original facial movements, emotions, and lip sync from the source video.
Temporal consistency: Minimizes flickering and artifacts across frames for stable, realistic results.
Multi-face support: Handle videos with multiple people — target specific faces by index.
High fidelity output: Maintains video quality with sharp facial details and smooth edges.

Parameters

Parameter	Required	Description
video	Yes	Source video file (upload or public URL). Max 10 minutes.
face_image	Yes	Reference face image to swap in (upload or public URL).
target_index	No	Select which face to swap when multiple faces exist. 0 = largest face, 1 = second largest, etc. Default: 0.

How to Use

Upload your video — drag and drop or paste a public URL.
Upload the face image — provide the face you want to swap in.
Set target index (optional):

Use target_index to select a specific face (0 = largest face).

Run — click the button and wait for processing.
Download — preview and save your swapped video.

Pricing

Per-second billing with a 5-second minimum. Maximum video length: 10 minutes.

Duration	Cost
Per 5 seconds	$0.05
Per second	$0.01

Billing Rules

Minimum charge: 5 seconds ($0.05)
Per-second rate: $0.01
Billed duration: Video length in seconds (rounded up), with 5-second minimum
Total cost: Billed duration × $0.01

Examples

Video Length	Calculation	Total Cost
3s	5s minimum × $0.01	$0.05
15s	15 × $0.01	$0.15
1m 30s (90s)	90 × $0.01	$0.90
5m (300s)	300 × $0.01	$3.00

Best Use Cases

Content Creation — Create entertaining face-swap videos for social media and viral content.
Film & Video Production — Replace stunt doubles or create special effects without expensive post-production.
Marketing & Advertising — Personalize video ads with localized faces for different markets.
Entertainment & Memes — Generate fun, shareable content with celebrity or character face swaps.
Privacy Protection — Anonymize faces in videos for privacy-sensitive content.

Pro Tips for Best Results

Use a clear, front-facing reference image with good lighting for the best match.
Source videos with stable, well-lit faces produce smoother results.
For videos with multiple people, use target_index to precisely control which face gets swapped.
Keep the reference face angle similar to the faces in the video for more natural blending.

Notes

If using a URL for the face image, ensure it is publicly accessible. A preview thumbnail in the interface confirms successful loading.
Processing time varies based on video length and current queue load.
For videos longer than 10 minutes, split into segments and process separately.

Video Face Swap API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/wavespeed-ai/video-face-swap with your input as JSON. The endpoint returns a prediction id; poll the prediction endpoint until status flips to completed, then read the output URL from data.outputs[0]. Examples for Video Face Swap below.

HTTP example

# Submit the prediction
curl -X POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/video-face-swap" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d '{
    "video": "https://example.com/your-input.mp4",
    "target_index": 0
}'

# Response includes a prediction id. Poll for the result:
curl -X GET "https://api.wavespeed.ai/api/v3/predictions/{request_id}/result" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY"

# When status is "completed", read the output from data.outputs[0].

Node.js example

// npm install wavespeed
const WaveSpeed = require('wavespeed');

const client = new WaveSpeed(); // reads WAVESPEED_API_KEY from env

const result = await client.run("wavespeed-ai/video-face-swap", {
        "video": "https://example.com/your-input.mp4",
        "target_index": 0
});

console.log(result.outputs[0]); // → URL of the generated output

Python example

# pip install wavespeed
import wavespeed

output = wavespeed.run(
    "wavespeed-ai/video-face-swap",
    {
    "video": "https://example.com/your-input.mp4",
    "target_index": 0
}
)

print(output["outputs"][0])  # → URL of the generated output

Video Face Swap API — Frequently asked questions

What is the Video Face Swap API?

Video Face Swap is a WaveSpeedAI model for AI inference, exposed as a REST API on WaveSpeedAI. Swap faces in any video by uploading a video and an image — perform unlimited, seamless face replacements quickly. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing. You can call it programmatically or try it from the playground above.

How do I call the Video Face Swap API?

POST your input parameters to the model's REST endpoint (shown in the API tab of this playground) with your WaveSpeedAI API key in the Authorization header. Submission returns a prediction ID; poll the prediction endpoint until status flips to "completed", then read the output URL from the result. The playground generates a ready-to-paste code sample in Python, JavaScript, or cURL for whatever inputs you've set. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/wavespeed-ai/video-face-swap.

How much does Video Face Swap cost per run?

Video Face Swap starts at $0.050 per run. That figure is the base price — the final charge scales with the parameters you set in the form (output size, length, count, references, or whatever knobs this model exposes), so a higher-quality or larger output costs more than a minimal one. The exact cost for your current input is shown live next to the Generate button before you submit, and the actual per-call charge is recorded on the prediction afterwards.

What inputs does Video Face Swap accept?

Key inputs: `video`, `face_image`, `target_index`. The full JSON schema (types, defaults, allowed values) is rendered above the Generate button and mirrored in the API reference at https://wavespeed.ai/docs/docs-api/wavespeed-ai/video-face-swap.

How long does Video Face Swap take to generate?

Average end-to-end generation time on WaveSpeedAI is around 135 seconds per request — measured across recent runs. Queue time scales with global demand; live status is visible in the prediction record.

Can I use Video Face Swap outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (WaveSpeedAI). The license summary appears on the model card above; see WaveSpeedAI's Terms of Service for platform-level conditions.

PrzykładyZobacz wszystkie

Powiązane modele

README