如何使用 人脸检测 API：换脸接入指南（2026）

人脸检测 是一款换脸模型（由 NamiFusion 提供）：人脸检测模型, 用于检测输入元素中包含的人脸信息在 NamiFusion 上可以在 Playground 直接试玩（提交前显示准确报价），再通过统一 REST API 一行代码接入。

TL;DR

· 任务类型：换脸，由 NamiFusion 提供

· 价格：按量积分计费（$1 = 100 积分），无订阅

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

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

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

用 人脸检测 能做什么？

影视与短剧后期：替换演员面部做补拍救场或多语言版本本地化。

玩梗与娱乐内容：把朋友或自己的脸放进名场面，社媒传播利器。

虚拟形象与隐私保护：直播、出镜内容用替代面部保护真实身份。

批量生产：同一素材一次映射多张源脸，量产个性化版本。

怎么调用这个 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/detect_faces" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "url": "https://assets-public.namifusion.com/marketplace/thumbnails/2026-02-25/fb559d5bc3dc.png",
    "num_frames": 5,
    "return_face_url": true,
    "single_face": false,
    "deduplicate": true,
    "similarity_threshold": 0.45,
    "time_range": {}
  }
}'

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

有哪些参数？

url（媒体URL）：可选

img（Base64图片）：可选

num_frames（抽帧数量）：可选，默认 5

return_face_url（返回人脸URL）：可选，默认 true

single_face（仅返回最大人脸）：可选，默认 false

deduplicate（人脸去重）：可选，默认 true

similarity_threshold（相似度阈值）：可选，默认 0.45

time_range（时间区间）：可选，默认 {}

人脸检测 的提示词怎么写？

1. 主体在前：先写画面主角与动作，再补环境、光线、风格（"一名宇航员在雨中的霓虹街头奔跑，电影感，浅景深"）。

2. 用具体名词代替形容词堆砌："85mm 人像镜头、黄昏逆光" 比 "非常好看、超高质量" 有效得多。

3. 迭代时只改一个变量：固定 seed 复现结果，每次只调整一个描述词，才能知道是什么在起作用。

4. 负面信息放正面写：与其说"不要模糊"，不如直接要"锐利对焦、清晰细节"。

价格是多少？

按次积分计价（$1 = 100 积分），价格随参数变化，Playground 里提交前会显示准确报价。