How to Use the namifusion Image/Video Face Swap API: face swap integration guide (2026)
Learn how to call the namifusion Image/Video Face Swap API on NamiFusion: parameters, pricing (from ≈$0.400) and runnable copy-paste code — try it in the playground first.
namifusion Image/Video Face Swap is a face swap model by NamiFusion: NamiFusion Video Face Swap Model Supports images and videos, easy single or multi-person face swapping. Compatible with multiple model_style options, can output realistic results or one-click beauty-enhanced versions — natural and great-looking! On NamiFusion you can try it in the playground (exact quote shown before you submit), then call it through one unified REST API — a typical run costs about $0.400.
TL;DR
· Task type: face swap, provided by NamiFusion
· Pricing: about $0.400 per typical run ($1 = 100 credits), pay-as-you-go
· Getting started: playground (exact quote before submit) → create an API key → one POST request
· Tunable parameters: 5 (see the table below)
· No platform watermark; commercial use allowed (per the Terms of Service)
What can you build with namifusion Image/Video Face Swap?
Film and short-drama post-production: replace faces for reshoots or multi-language localization.
Memes and entertainment: put yourself or friends into iconic scenes — built for social sharing.
Virtual personas and privacy: use a substitute face for streams and on-camera content.
Batch production: map multiple source faces onto the same footage to mass-produce personalized versions.
How do you call this API?
1. Sign up on NamiFusion and create a key on the API Keys page (free credits on signup).
2. Submit a task with the cURL example below, passing your key as a Bearer token.
3. Poll the task status with the returned task_uuid and read the output URLs when completed.
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/namifusion/faceswap-video" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"source_url": "https://assets-public.namifusion.com/marketplace/thumbnails/2026-01-27/d0328839a75f.png",
"single_face_mode": true,
"model_style": "realistic",
"face_enhance": false,
"face_mapping": []
}
}'
# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
-H "Authorization: Bearer YOUR_API_KEY"What parameters does it take?
source_url (Source Face): required
single_face_mode (Single-face swap): optional
model_style (model style): optional, default "realistic"
face_enhance (Face enhancement): optional
face_mapping (Face mapping): optional, default []
How much does it cost?
Pay-per-use in credits. A typical run costs about $0.400 ($1 = 100 credits); the exact price varies with parameters like resolution or duration, and the playground shows the exact quote before you submit.
namifusion Image/Video Face Swap
AI Video Face Swap: Supports single-person automatic face swap and multi-person precise mapping, combined with face detection for a complete video face swap workflow.
NamiFusion Video FaceSwap is a high-quality AI video face swap service that replaces source faces onto target videos. It offers two modes: single-person face swap (automatic mode) and multi-person face swap (precise mapping mode), and can be combined with NamiFusion Detect Faces to achieve a complete workflow from face detection to face swapping.
Key Features
- Single-Person Face Swap: Enable
single_face_modeto automatically complete the face swap without any additional configuration. - Multi-Person Precise Mapping: Use
face_mappingto precisely specify the correspondence between source faces and target faces, supporting one-to-one and many-to-many mappings. - Face Enhancement: Optional advanced beautification that automatically smooths skin and removes facial blemishes, improving post-swap face quality.
- Async Tasks: Returns a
task_uuidafter submission; retrieve results via polling or Webhook.
Technical Specifications
| Parameter | Details |
|---|---|
| Model ID | namifusion/faceswap-video |
| Request Method | Async POST (submit task + poll/Webhook for results) |
| Input | Source face image URL + target video URL |
| Output | Face-swapped video URL |
| Processing Time | Typically 30 seconds to several minutes (depends on video duration and resolution) |
Quick Start
API Endpoints
| Endpoint | Method | Description |
|---|---|---|
/api/v1/marketplace/run/namifusion/faceswap-video | POST | Submit a video face swap task |
/api/v1/marketplace/run/tasks/{task_uuid} | GET | Query task status and results |
Authentication
Include your API Key in the request header:
X-API-Key: sk-your-api-key
FAQ
Can I try it for free first?+
Signup gives you free credits, but they currently apply only to selected in-app face-swap features — this model is pay-as-you-go. The playground still lets you try it without code, with the exact quote shown before you submit.
Can I use the output commercially? Is there a watermark?+
Yes, outputs are yours to use commercially, and NamiFusion adds no platform watermark — subject to the Terms of Service and applicable law.
What is the content policy?+
NamiFusion is an unfiltered engine: no arbitrary restrictions and NSFW-friendly, but illegal content and non-consensual use of real people are prohibited — see the Terms of Service.
How long does a namifusion Image/Video Face Swap task take?+
It depends on parameters — images usually take seconds, videos tens of seconds to minutes. The API returns a task_uuid for polling.
What are the resolution and duration limits?+
See the parameter table above — each model lists its available resolution and duration options there and in the playground.