Muapi 换脸 API 可以将现有图像或视频中的人脸替换为源照片中的人脸，同时保留光照、表情和肤色。使用一个 REST API，并沿用平台统一的提交与轮询流程。
2 / 2 个模型
什么是换脸 API？
换脸 API 接收一张源人脸照片和已有图像或视频，然后替换目标人脸，同时保留光照、表情和肤色。
Muapi 提供独立的图像和视频端点，使用一个 API 密钥、统一的提交与轮询流程以及按次计费。
主要能力
覆盖图像与视频
静态照片使用图像端点，视频使用逐帧替换端点。
多人脸选择
使用 target_index 选择群像或多人场景中需要替换的检测人脸。
视频性别筛选
视频端点支持 target_gender 筛选，适用于多人视频。
保留光照与表情
模型将源身份自然融合到目标中，同时保留目标光照和动作。
与口型同步组合
将换脸模型与口型同步模型组合，在一个工作流中完成换脸和语音同步。
按次生成付费
图像换脸每次 $0.02；视频换脸根据视频时长计费。
换脸模型对比
| 模型 | 输入 | 价格 | 适合场景 |
|---|---|---|---|
| AI Image Face Swap | 两张图像 | $0.02/次生成 | 照片、表情包和头像 |
| AI Video Face Swap | 图像 + 视频 | 约 $0.10/秒 | 逐帧视频换脸 |
两个端点中字段的含义不同。在图像和视频换脸之间切换时，请仔细查看模型参数结构。
如何调用换脸 API
- 托管媒体文件。 通过 POST /api/v1/upload_file 上传，或使用可公开访问的图像和视频 URL。
- 选择端点。 目标是图像时使用 ai-image-face-swap，目标是视频时使用 ai-video-face-swap。
- 提交请求。 传入所选端点要求的源图像和目标媒体字段，并按需设置目标人脸选择参数。
- 轮询并下载。 持续轮询 GET /api/v1/predictions/{request_id}/result，完成后保存输出。
curl -X POST https://api.muapi.ai/api/v1/ai-image-face-swap \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"image_url": "https://example.com/target-scene.jpg",
"swap_url": "https://example.com/source-face.jpg"
}'import requests
response = requests.post(
"https://api.muapi.ai/api/v1/ai-image-face-swap",
headers={"x-api-key": "YOUR_API_KEY"},
json={
"image_url": "https://example.com/target-scene.jpg",
"swap_url": "https://example.com/source-face.jpg",
},
)
request_id = response.json()["request_id"]
result = requests.get(
f"https://api.muapi.ai/api/v1/predictions/{request_id}/result",
headers={"x-api-key": "YOUR_API_KEY"},
)
print(result.json())常见问题
什么是换脸 API？
换脸 API 通过两个 REST 端点，将现有图像或视频中的人脸替换为源照片中的人脸。
换脸需要多少钱？
图像换脸每次 $0.02；视频换脸根据时长计费，实际约为每秒 $0.10。
可以选择要替换的人脸吗？
可以。两个端点都支持 target_index，视频端点还支持 target_gender 筛选。
有哪些输入限制？
请使用清晰、正面的源人脸图像，并在 Playground 中查看所选模型的媒体大小、分辨率和帧数限制。
可以提交谁的照片？
只能提交已同意此用途的人的照片。未经许可，不要使用他人的肖像冒充本人。