How to Use the namifusion Image Face Swap API: face swap integration guide (2026)
Learn how to call the namifusion Image Face Swap API on NamiFusion: parameters, pricing (from ≈$0.150) and runnable copy-paste code — try it in the playground first.
namifusion Image Face Swap is a face swap model by NamiFusion: NamiFusion Face Swap Model 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.150.
TL;DR
· Task type: face swap, provided by NamiFusion
· Pricing: about $0.150 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: 6 (see the table below)
· No platform watermark; commercial use allowed (per the Terms of Service)
What can you build with namifusion Image 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-image" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"source_url": "https://kaito-1328216764.cos.ap-tokyo.myqcloud.com/marketplace/thumbnails/2026-01-27/d0328839a75f.png",
"target_url": "https://kaito-1328216764.cos.ap-tokyo.myqcloud.com/marketplace/thumbnails/2026-02-24/94a3eefdb397.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
target_url (Target 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.150 ($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 Face Swap
AI Image Face Swap: Supports single-person automatic face swap and multi-person precise mapping, combined with face detection for a complete face swap workflow.
NamiFusion Image FaceSwap is a high-quality AI image face swap service that replaces source faces onto target images. 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-image |
| Request Method | Async POST (submit task + poll/Webhook for results) |
| Input | Source face image URL + target image URL |
| Output | Face-swapped image URL |
| Processing Time | Typically 5~15 seconds |
Quick Start
API Endpoints
| Endpoint | Method | Description |
|---|---|---|
/api/v1/marketplace/run/namifusion/faceswap-image | POST | Submit a 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 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.