Face Swap API – Swap Faces Between Two Photos

Swap a face from a source image onto a target image. Upload two photos and receive the face-swapped result as a binary image.

原始信息汇总

Face Swap API – Swap Faces Between Two Photos

概述

该API用于将一张源图像中的人脸与另一张目标图像中的人脸进行交换。用户上传两张照片，即可获得人脸交换后的合成图像。

主要功能

• 人脸交换：将源图像中的人脸交换到目标图像上。
• 自动人脸检测：无需指定人脸坐标。
• 直接二进制输出：成功时返回可直接显示或存储的合成图像。

适用场景

• 娱乐和社交媒体应用提供换脸功能。
• 营销团队创建个性化宣传图像。
• 内容创作者和表情包生成器。
• 电影预制作团队进行人脸替换原型设计。
• 照片编辑应用添加创意人脸处理工具。

不适用场景

• 单次请求交换多张人脸（每次请求仅处理一对人脸）。
• 实时视频人脸交换（此为单图像端点）。
• 用于欺骗目的的深度伪造。
• 身份验证或认证。

技术规格

• 端点：POST /v1/face/swap
• 请求方法：POST
• 输入格式：支持JPEG、PNG、BMP、WEBP、GIF格式的图像文件。
• 文件大小限制：每张图像最大10 MB。
• 输出格式：成功时返回二进制图像（JPEG或PNG），Content-Type为image/png或image/jpeg。

请求参数

参数	类型	是否必需	描述
target_image	文件	是	将被替换人脸的图像。支持JPEG、PNG、BMP、WEBP、GIF格式，最大10 MB。
source_image	文件	是	提供替换人脸的源图像。支持JPEG、PNG、BMP、WEBP、GIF格式，最大10 MB。

错误处理

• 错误响应格式：所有错误响应遵循统一格式：{ "meta": {...}, "data": null, "warnings": [], "error": { ... } }。
• 常见错误：
  • 缺少目标图像或源图像：返回400错误。
  • 无效的文件格式：返回400错误。
  • 文件过大：返回400错误。
  • 上游处理服务超时或失败：返回502错误。
  • 服务器意外错误：返回500错误。

优势特点

• 双图像输入：分离的目标和源图像，可精确控制交换过程。
• 广泛的格式支持：接受JPEG、PNG、BMP、WEBP和GIF格式。
• 一致的错误格式：标准的meta、data、warnings、error信封结构。

提供商信息

• API创建者：APISphere
• 类别：Video, Images