如何使用 图片换脸V5 API：换脸接入指南（2026）

AI 图片换脸 v5：超高速人脸与智能换头，内置肤色匹配，专为高并发生产级工作流设计。

NamiFusion Faceswap v5 是一款面向速度与规模的图片换脸 API。它在保持与 Faceswap v2 同等推理速度的同时，大幅提升了输出质量，具备自动智能换头、内置肤色匹配和创意提示词支持——且是 NamiFusion 换脸系列中成本最低的选项。

核心特性

• 超高速推理： 与 Faceswap v2 速度持平，同时输出质量显著提升。
• 智能换头： 自动判断使用仅换脸还是整头融合，以获得最自然的效果——无需手动选择模式。
• 内置肤色匹配： 自动适配肤色，无需手动校色即可获得自然无缝的结果。
• 创意提示词支持： 使用 additional_prompt 引导细微属性变化，例如"戴帽子"或"微笑"。
• 可复现输出： 基于 seed 的生成机制确保每次运行结果一致，非常适合 A/B 测试和批量工作流。
• 成本优化： NamiFusion 换脸系列中最实惠的选项，不牺牲专业级输出质量。

技术规格

快速开始

API 端点

Faceswap v5 采用同步响应模式——结果直接在响应体中返回，无需轮询。

请求参数概览

请求体中 Faceswap v5 的核心字段如下：

{
  "source_image": "string（URL）",
  "target_image": "string（URL）",
  "additional_prompt": "string",
  "image_format": "png | jpeg | webp",
  "quality": 95,
  "seed": 8005332
}

鉴权

在请求头中携带您的 API Key：

X-API-Key: sk-your-api-key

标准调用流程

Faceswap v5 采用同步工作流——结果图片直接返回：

1. 携带输入参数调用 POST /api/v1/marketplace/run/namifusion/faceswap-v5。
2. 响应体中直接包含结果图片。
3. 无需轮询步骤。

提交任务并获取结果

curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/namifusion/faceswap-v5" \
  -H "X-API-Key: sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "source_image": "https://example.com/source.jpg",
      "target_image": "https://example.com/target.jpg",
      "image_format": "png",
      "quality": 95,
      "seed": 8005332
    }
  }'

成功响应示例：

{
  "status": "completed",
  "output": {
    "image_url": "https://cdn.namifusion.com/result/faceswap_v5_abc123.png"
  }
}

失败响应示例：

{
  "status": "failed",
  "output": null,
  "error_message": "Face swap failed because no valid face was detected in source_image."
}