如何使用 namifusion 图片换脸 API：换脸接入指南（2026）
namifusion 图片换脸 API 接入教程：参数说明、价格与可直接运行的调用代码，先在 Playground 试玩再一行代码接入。
namifusion 图片换脸 是一款换脸模型（由 NamiFusion 提供）：NamiFusion 换脸模型 轻松实现单人或多人换脸。兼容多种 model_style 风格，可直接输出真实效果或一键美颜优化结果，换脸自然又好看！在 NamiFusion 上可以在 Playground 直接试玩（提交前显示准确报价），再通过统一 REST API 一行代码接入，典型一次调用约 $0.150。
TL;DR
· 任务类型：换脸，由 NamiFusion 提供
· 价格：典型一次约 $0.150（$1 = 100 积分），按量计费无订阅
· 上手路径：Playground 试玩（提交前显示报价）→ API Keys 建密钥 → 一个 POST 接入
· 可调参数：6 个（见下方参数表）
· 无平台水印，商用可用（遵守服务条款）
用 namifusion 图片换脸 能做什么？
影视与短剧后期：替换演员面部做补拍救场或多语言版本本地化。
玩梗与娱乐内容：把朋友或自己的脸放进名场面，社媒传播利器。
虚拟形象与隐私保护：直播、出镜内容用替代面部保护真实身份。
批量生产：同一素材一次映射多张源脸，量产个性化版本。
怎么调用这个 API？
1. 在 NamiFusion 注册并在 API Keys 页面创建密钥（注册送免费积分）。
2. 用下面的 cURL 示例提交任务，Header 带上 Bearer 密钥。
3. 用返回的 task_uuid 轮询任务状态，完成后取输出 URL。
# 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"有哪些参数？
source_url（源人脸）：必填
target_url（目标人脸）：必填
single_face_mode（是否单人换脸）：可选
model_style（模型风格）：可选，默认 "realistic"
face_enhance（人脸增强）：可选
face_mapping（人脸映射）：可选，默认 []
价格是多少？
按次积分计价，典型一次调用约 $0.150（$1 = 100 积分），实际价格随参数（分辨率/时长等）变化，Playground 里提交前会显示准确报价。
namifusion 图片换脸
AI 图片换脸：支持单人自动换脸与多人精确映射，搭配人脸检测实现完整换脸工作流。
NamiFusion Image FaceSwap 是一个高质量 AI 图片换脸服务，支持将源人脸替换到目标图片中。它提供单人换脸（自动模式）和多人换脸（精确映射模式）两种用法，并可搭配 NamiFusion Detect Faces 实现从人脸检测到换脸的完整工作流。
核心特性
- 单人换脸： 开启
single_face_mode即可自动完成换脸，无需任何额外配置。 - 多人精确映射： 通过
face_mapping精确指定源人脸与目标人脸的对应关系，支持一对一、多对多映射。 - 面部优化： 可选的高级美颜功能，自动磨皮并消除脸部瑕疵，提升换脸后的面部质量。
- 异步任务： 提交后返回
task_uuid，通过轮询或 Webhook 获取结果。
技术规格
| 参数 | 详情 |
|---|---|
| 模型 ID | namifusion/faceswap-image |
| 请求方式 | 异步 POST（提交任务 + 轮询/Webhook 获取结果） |
| 输入 | 源人脸图片 URL + 目标图片 URL |
| 输出 | 换脸后的图片 URL |
| 处理时间 | 通常 5~15 秒 |
快速开始
API 端点
| 端点 | 方法 | 说明 |
|---|---|---|
/api/v1/marketplace/run/namifusion/faceswap-image | POST | 提交换脸任务 |
/api/v1/marketplace/run/tasks/{task_uuid} | GET | 查询任务状态与结果 |
认证
在请求 Header 中携带您的 API Key：
X-API-Key: sk-your-api-key
FAQ
可以先免费试用吗？+
注册即送积分，但赠送积分目前仅适用于应用内的部分换脸功能；本模型按量积分计费。Playground 仍可无代码试玩，提交前会显示准确报价。
生成内容可以商用吗？有水印吗？+
可以商用，NamiFusion 不给生成结果加平台水印；使用须遵守服务条款与适用法律。
内容政策是什么？+
NamiFusion 是无过滤引擎，不做武断限制、对 NSFW 友好，但禁止违法内容与非自愿的真人素材，详见服务条款。
namifusion 图片换脸 的任务要跑多久？+
取决于参数，图像通常数秒到数十秒，视频通常数十秒到几分钟；API 返回 task_uuid 供轮询。
分辨率/时长上限是多少？+
以模型参数表为准：每个模型的可选分辨率、时长档位都在上方参数说明与 Playground 中列出。