图片换头

namifusion/head-swap/image-edit

将照片中的人物头部替换为参考图中的头部。先上传目标照片，再上传头部参考图。

参数

名称	类型	默认	约束	说明
images *图片	image_upload	—	2–2 items	恰好 2 张：第 1 张为头部参考图，第 2 张为目标照片

输出字段

字段	类型	说明
images	array<string>

API

通过统一 REST API 调用本模型；在 API Keys 页获取密钥。

cURL

# 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"

Python

import time, requests

API_KEY = "YOUR_API_KEY"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

# 1) Submit
resp = requests.post(
    "https://www.namifusion.com/api/v1/marketplace/run/namifusion/head-swap/image-edit",
    headers=HEADERS,
    json={
        "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"
            ]
        }
    },
)
resp.raise_for_status()  # 401/402/429/5xx stop here instead of polling a bad task
task = resp.json()

# 2) Poll until a terminal state (completed / failed / cancelled).
#    This model is allowed up to 600s server-side.
deadline = time.time() + 660
while task.get("status") not in ("completed", "failed", "cancelled"):
    if time.time() > deadline:
        raise TimeoutError(f"still {task.get('status')} — keep the task_uuid and poll later")
    time.sleep(3)
    poll = requests.get(f"https://www.namifusion.com/api/v1/marketplace/run/tasks/{task['task_uuid']}", headers=HEADERS)
    poll.raise_for_status()
    task = poll.json()

print(task["status"], task.get("output"))

JavaScript

const API_KEY = "YOUR_API_KEY";
const HEADERS = { Authorization: `Bearer ${API_KEY}` };

// 1) Submit
const resp = await fetch("https://www.namifusion.com/api/v1/marketplace/run/namifusion/head-swap/image-edit", {
  method: "POST",
  headers: { ...HEADERS, "Content-Type": "application/json" },
  body: JSON.stringify({
    "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"
      ]
    }
  }),
});
if (!resp.ok) throw new Error(`submit failed: ${resp.status} ${await resp.text()}`);
let task = await resp.json();

// 2) Poll until a terminal state (completed / failed / cancelled).
//    This model is allowed up to 600s server-side.
const deadline = Date.now() + 660 * 1000;
while (!["completed", "failed", "cancelled"].includes(task.status)) {
  if (Date.now() > deadline) throw new Error(`still ${task.status} — keep the task_uuid and poll later`);
  await new Promise((r) => setTimeout(r, 3000));
  const poll = await fetch(`https://www.namifusion.com/api/v1/marketplace/run/tasks/${task.task_uuid}`, { headers: HEADERS });
  if (!poll.ok) throw new Error(`poll failed: ${poll.status}`);
  task = await poll.json();
}

console.log(task.status, task.output);

文档

图片换头

将第一张参考图中的头部迁移到目标照片，同时保留目标图的身体、姿态与场景。

图片换头是一个专门处理双图输入的编辑流程，用于替换目标照片中的人物头部。第 1 张图片提供头部参考与身份特征，第 2 张图片提供需要保留的身体、姿态、服装、光线环境和背景。固定的输入顺序让流程保持简单，但顺序必须正确，否则模型会错误理解参考图与目标图的角色。

核心特性

专门的头部替换：以目标照片为底图，仅重点修改头部区域。
双图明确控制：身份参考和目标构图分别由两张图片提供，不依赖文字提示词。
保留姿态与场景：设计目标是维持目标图中的身体、服装、取景和背景。
输入契约简单：只需按规定顺序提供恰好两个图片 URL。
统一方形输出：生成 1024 x 1024 图片，便于后续展示和处理。

技术规格

项目	说明
任务类型	头部替换 / 图片编辑
必填输入	`images`，恰好两个图片 URL
第 1 张图片	头部与身份参考
第 2 张图片	目标照片与基础构图
输入顺序	先参考图，后目标图
提示词	不需要
输出	编辑后图片 URL
输出尺寸	1024 x 1024