如何使用 换头 – 视频生成 API：character swap接入指南（2026）

换头 – 视频生成 是一款character swap模型（由 NamiFusion 提供）：用 Wan2.2-Animate 将视频中选定头部替换为参考图人物头部，保留原始音轨。在 NamiFusion 上可以在 Playground 直接试玩（提交前显示准确报价），再通过统一 REST API 一行代码接入，典型一次调用约 $0.750。

TL;DR

· 任务类型：character swap，由 NamiFusion 提供

· 价格：典型一次调用约 $0.750（$1 = 100 积分），按量计费无订阅

· 上手路径：Playground 试玩（提交前显示报价）→ API Keys 建密钥 → 一个 POST 接入

· 可调参数：4 个（见下方参数表）

· 无平台水印，商用可用（遵守服务条款）

用 换头 – 视频生成 能做什么？

内容生产自动化：把该模型接入你的工作流，用统一 API 按量调用。

怎么调用这个 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/head-swap/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "track_manifest_url": "ANALYZE_OUTPUT.track_manifest_url",
    "mappings": [
      {
        "obj_id": 0,
        "img_urls": [
          "https://assets-public.namifusion.com/marketplace/images/2026-06-12/638e1ee18ac7.jpeg"
        ]
      }
    ],
    "resolution": "720p"
  }
}'

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

有哪些参数？

track_manifest_url（Track manifest URL）：必填

mappings（头部映射）：必填

resolution（分辨率）：可选，默认 "720p"

seed（随机种子）：可选

价格是多少？

按次积分计价，典型一次调用约 $0.750（$1 = 100 积分），实际价格随参数（分辨率/时长等）变化，Playground 里提交前会显示准确报价。