换头 vs 换脸：我需要哪一个？

换脸改变面部特征，保留目标的头发和头部形状。换头替换整个头部，源头部的发型和轮廓也一起换过来。希望保留头发时用 Face Swap；希望人物从脖子以上都像源头部（连头发一起）时用 Head Swap。

什么样的照片最适合 AI 换头？

源头部完整可见、包括头发，朝向与目标大致相同，光线均匀；目标照片中头部清晰可见且不太小。两张图片都以公开 http(s) URL 发送。

我能在视频或多个人上进行换头吗？

不能。Head Swap 适用于一张静止图像，每次请求返回一张图像。此模型不支持视频。

我能在 Playground 中使用 Head Swap 吗？

能。本页的 Playground 运行与 API 相同的模型，所以你可以进行在线换头：登录，粘贴目标照片 URL 和源头部 URL，然后运行。对于批处理和你自己的产品，用 API 密钥调用端点。

Head Swap 有内容过滤吗？

没有。Head Swap 上没有 content_filter 参数，发送它会返回 400 错误而非被忽略。将其用于你有权使用肖像的人。平台条款适用于你生成的一切。

我如何获得相同的换头结果？

设置种子，任何从 0 到 2147483647 的整数。同一目标照片、源头部和种子会返回同一图像。省略种子或设为 0 以每次获得全新结果。

Head Swap 是免费还是付费？

付费。完成的交换按上方价格表中的单张固定费率计费。符合条件的新账户可能收到促销测试积分，显示在注册或控制面板。失败和被拒的请求自动退款。

Head Swap 需要按月订阅吗？

不需要。定价是按量付费：$1 购买 1000 积分，积分永不过期。你按生成的 Head Swap 图像数量付费，没有月费。

我如何获取 Head Swap API 密钥？

注册并在控制面板创建密钥，无需信用卡。作为 Authorization 请求头中的 Bearer token 传入。该密钥用于从你自己的代码调用 Head Swap；本页的 Playground 仅需登录账户。

Head Swap — AI 换头，连头发一起，一次调用

Head Swap 将目标照片中的整个头部替换为源照片中的头部：脸、头发、耳朵和轮廓。姿态、光影和背景保持不变。在下方尝试，或使用 API 密钥调用，每张固定价格。

模型特点: 整头替换 · 头发、脸和轮廓一起替换 · 种子控制
适用场景: 必须连同头发和头部形状一起改变的照片
输入: 目标照片 + 源头部
输出: 每次请求一张已交换的图像

Input

目标照片*

playground-target.webp

Replace

✓ 1 file added

https://file.deepytb.com/landing/head-swap/playground-target.webp

1/1 file

必填 · 公开的 http(s) URL

源头部*

playground-head.webp

Replace

✓ 1 file added

https://file.deepytb.com/landing/head-swap/playground-head.webp

1/1 file

必填 · 公开的 http(s) URL

种子

0–2147483647 · 0 或留空 = 随机

Estimated cost~$0.01313 credits

Result

什么是 Head Swap？

Head Swap 是 reAPI 上的一个图像到图像模型，公开为一个异步端点，包含三个参数：目标照片、源头部和可选的种子。它将目标照片中的整个头部替换为源头部，连头发和轮廓一起，并保留目标的身体、姿态、光影和背景。每次请求一张图像，固定费率，可在本页的 Playground 或通过 API 使用。

你能用这个模型做什么

可以用这个模型构建并上线的真实工作流与生产级用例。

为角色和头像进行换头

当头发是身份的一部分时，换脸是不够的。Head Swap 会把整个头部一起换过去，角色无论放在哪个身体、哪个场景里，都能靠一次 API 调用保持原来的样子。

阅读 API 文档

Head Swap 前后对比 — 一张办公室肖像，整个头部被替换，套装和大厅未变

复用一次拍摄，换一个人

保留衣着、姿态和场景，只换穿着它的人。Head Swap 保留目标的身体和背景，把头部换成源头部，连头发一起。

Head Swap 批处理 — 同一个市集摊位肖像换上三个不同的源头部，并排显示

批量换头，获得可重复的结果

固定种子，同一两张照片每次都能得到相同的结果。一夜之间用一组源头部跑同一个场景，留下效果好的。

价格

积分计费 — 1 积分 = 0.001 美元，仅为成功生成付费。

首次测试成本

$0.01313 credits

最低档一次生成（1 image）。

测试预算参考

充值积分

$10

约 769 次测试

$50

约 3846 次测试

$100

约 7692 次测试

模型	类别	价格
head-swap	每张图	$0.013 13 credits · 1 image

为什么选 reAPI

整个头部，包括头发

换脸保留目标的头发和头部形状。Head Swap 把源头部的头发、轮廓和耳朵一起带过来，所以相似度高得多。

无内容过滤，仅一条路由

这个模型上没有内容过滤开关，因为没有过滤路由可供切换。在本页运行或用 API 密钥调用。平台条款仍然适用。

固定价格、异步、失败退款

1 积分等于 $0.001 美元。Head Swap 按单张图的固定费率计费，与照片尺寸无关。POST、获得 task_id、轮询。失败的交换会自动退款。

reAPI 上的 Head Swap vs 图像编辑器中的手工换头

两者都将不同的头部放到照片上。reAPI 上的 Head Swap 是一个 HTTP 调用，两个图像 URL；手工换头是图像编辑器中的遮罩和混合工作，每张图片手工重做。

功能

reAPI 上的 Head Swap

编辑器中的手工换头

设置

无。一个 API 密钥和一个 POST。

一个编辑器许可证、一个遮罩、和懂得如何混合肤色和边缘的人。

输入

两个公开图像 URL：目标照片和源头部。

分层文件；源头部由人工裁剪、缩放和旋转。

转移的内容

源头部的脸、头发、耳朵和轮廓；目标的身体、姿态、光和背景保留。

你遮罩的任何东西；匹配光线和颈边是手工工作。

每张图的工作量

秒级 API 时间，无手工步骤。

分钟到小时，取决于头发和光线。

定价结构

每张图的固定费率；失败的交换会退款。

编辑器许可证加上人工时间，按张计。

可重现性

种子参数：同一输入和种子返回同一图像。

每次编辑都是唯一的；重复结果意味着重做它。

对比反映撰写时的公开文档行为。模型行为和定价可能变化；当前值请查看上方价格卡和 API 文档。

三步接入 Head Swap

step 01
创建 API 密钥
先在本页 Playground 中尝试 Head Swap。对于你自己的代码，注册，在控制面板创建密钥，并将其作为 Bearer token 传入。
打开
step 02
提交两张照片
向 /api/v1/images/generations 发起 POST，带上 model: head-swap、目标照片的 image_url 和源头部的 head_image_url。你会立即获得 task_id。
打开
step 03
轮询结果
GET /api/v1/tasks/:id 直到 status 为 completed。Head Swap 图像 URL 有效期 30 天；如需更长期保存，请复制到你自己的存储。
打开

docs/api/head-swap

API 参考

复制即用的代码片段与完整参数表。

查看完整参考文档

curl -X POST https://reapi.ai/api/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "head-swap",
    "image_url": "https://example.com/target-photo.jpg",
    "head_image_url": "https://example.com/source-head.jpg"
  }'

参数校验失败

提交时同步拒绝并指明出错字段。检查枚举值、范围与 URL 字段——不产生任何扣费。

认证或余额问题

401 表示 Bearer 密钥缺失或无效；402 表示预扣额超出余额。密钥与积分在控制台管理。

内容或素材被拒

参考素材与生成结果都会经过自动审核。被拒的任务返回明确错误并全额退款。

任务失败或超时

进入失败状态的任务不会扣费——预扣自动退还。保留任务 ID，随时可重试。

常见问题

关于此模型的常见疑问。

Head Swap 是 reAPI 上的一个 AI 换头模型，将一张照片中的整个头部替换为另一张照片中的头部：脸、头发、耳朵和轮廓。发送目标照片和源头部，获得一张成品图像，保留目标的身体、姿态、光影和背景。模型 id 在 /api/v1/images/generations 上是 head-swap。