如何使用 图片换头 API：图生图接入指南（2026）
图片换头 API 接入教程：参数说明、价格与可直接运行的调用代码，先在 Playground 试玩再一行代码接入。
图片换头 是一款图生图模型（由 NamiFusion 提供）：将照片中的人物头部替换为参考图中的头部。先上传目标照片，再上传头部参考图。在 NamiFusion 上可以在 Playground 直接试玩（提交前显示准确报价），再通过统一 REST API 一行代码接入，典型一次调用约 $0.220。
TL;DR
· 任务类型：图生图，由 NamiFusion 提供
· 价格：典型一次调用约 $0.220（$1 = 100 积分），按量计费无订阅
· 上手路径：Playground 试玩（提交前显示报价）→ API Keys 建密钥 → 一个 POST 接入
· 可调参数：1 个（见下方参数表）
· 无平台水印，商用可用（遵守服务条款）
用 图片换头 能做什么？
社媒配图与封面：按帖子主题批量出图，统一风格后直接排期发布。
电商与广告素材：产品场景图、Banner 底图、A/B 测试的多版本视觉。
概念设计与灵感探索：角色、场景、风格板，用低成本快速迭代方向。
内容工作流串联：生成结果可直接作为图生视频或换脸的输入素材。
怎么调用这个 API？
- 在 NamiFusion 注册并在 API Keys 页面创建密钥（注册赠送积分仅可用于指定模型）。
- 用下面的 cURL 示例提交任务，Header 带上 Bearer 密钥。
- 用返回的 task_uuid 轮询任务状态，完成后取输出 URL。
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/namifusion/head-swap/image-edit" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"images": [
"https://assets-public.namifusion.com/uploads/images/2026-04-21/76c1186af77d.png",
"https://assets-public.namifusion.com/uploads/images/2026-04-21/149467630166.png"
]
}
}'
# 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"有哪些参数？
images（图片）：必填
价格是多少？
按次积分计价，典型一次调用约 $0.220（$1 = 100 积分），实际价格随参数（分辨率/时长等）变化，Playground 里提交前会显示准确报价。
图片换头
将第一张参考图中的头部迁移到目标照片，同时保留目标图的身体、姿态与场景。
图片换头是一个专门处理双图输入的编辑流程，用于替换目标照片中的人物头部。第 1 张图片提供头部参考与身份特征，第 2 张图片提供需要保留的身体、姿态、服装、光线环境和背景。固定的输入顺序让流程保持简单，但顺序必须正确，否则模型会错误理解参考图与目标图的角色。
核心特性
- 专门的头部替换：以目标照片为底图，仅重点修改头部区域。
- 双图明确控制：身份参考和目标构图分别由两张图片提供，不依赖文字提示词。
- 保留姿态与场景：设计目标是维持目标图中的身体、服装、取景和背景。
- 输入契约简单：只需按规定顺序提供恰好两个图片 URL。
- 统一方形输出：生成 1024 x 1024 图片，便于后续展示和处理。
技术规格
| 项目 | 说明 |
|---|---|
| 任务类型 | 头部替换 / 图片编辑 |
| 必填输入 | images，恰好两个图片 URL |
| 第 1 张图片 | 头部与身份参考 |
| 第 2 张图片 | 目标照片与基础构图 |
| 输入顺序 | 先参考图，后目标图 |
| 提示词 | 不需要 |
| 输出 | 编辑后图片 URL |
| 输出尺寸 | 1024 x 1024 |
输入建议
参考图应清晰展示头部，尽量避免遮挡和严重模糊。目标图中的头部、颈部以及相邻头发或服装边界应当清楚可见。两张图的拍摄角度和主光方向越接近，融合结果通常越自然。提交时必须保持“头部参考图在前、目标照片在后”的固定顺序。
常见问题
可以先免费试用吗？+
注册赠送积分仅可用于指定模型，适用范围会持续更新；Playground 提交前会显示准确报价。
生成内容可以商用吗？有水印吗？+
可以商用，NamiFusion 不给生成结果加平台水印；使用须遵守服务条款与适用法律。
内容政策是什么？+
色情内容、涉及未成年人的性化内容、未经授权使用真人、欺骗性冒充、诈骗与虚假代言均禁止。合法、自愿且非露骨的成年人主题可能被允许，详见服务条款。
图片换头 的任务要跑多久？+
取决于参数，图像通常数秒到数十秒，视频通常数十秒到几分钟；API 返回 task_uuid 供轮询。
分辨率/时长上限是多少？+
以模型参数表为准：每个模型的可选分辨率、时长档位都在上方参数说明与 Playground 中列出。