生产 API 参考
DeepSwapAI AI 换脸 API
用统一的生产接口接入照片、批量照片、合照映射、视频和 GIF 换脸。先查看关键契约、计费单位、任务状态与边界；完整字段和响应请打开英文 API 参考。
一个契约，五种工作流
HTTPS、multipart 上传与 JSON 任务状态
所有公开生成路由都使用 Bearer API 密钥，返回 taskId，并在同一路由通过 GET 查询任务状态。
鉴权Bearer API 密钥密钥只在创建时显示，服务端仅保存 SHA-256 哈希。
完成方式按 taskId 轮询终态为 COMPLETED、FAILED 或 CANCELLED。
计费方式一次性账户积分轮询 GET 不会产生新的生成扣费。
客户端资料OpenAPI 3.1 + Postman没有发布官方语言 SDK 或 webhook 回调。
直接回答
一个 API 账户覆盖五种换脸输入
照片、批量照片、合照多人映射、视频和 GIF 使用同一个生产域名与任务生命周期。请求前检查格式、大小、时长、目标数量和可用积分；提交后保存 taskId，并在对应的 GET 路由轮询。
打开英文完整 API 参考: 打开英文完整 API 参考. 查看本地化费用计算器.
当前公开契约
路由、计费单位和主要边界
| 工作流 | POST 路由 | 当前单位 | 主要边界 |
|---|---|---|---|
| 照片 | POST /api/ai-tasks | 3 积分 / 个输出 | 一张身份图和一张目标图 |
| 批量照片 | POST /api/ai-tasks/batch-face-swap | 3 积分 / 个输出 | 最多 20 张图片；合计 95 MB |
| 合照映射 | POST /api/ai-tasks/multi-face-swap | 3 积分 / 个选中人脸 | 最多映射 10 张脸；合计 95 MB |
| 视频 | POST /api/ai-tasks/video | 每向上取整 1 秒 2 积分；最低 6 积分 | MP4、MOV 或 WebM；300 秒；720p 或 1080p |
| GIF | POST /api/ai-tasks/gif | 每向上取整 1 秒 3 积分；最低 6 积分 | GIF、MP4 或 WebM；30 秒 |
最小集成流程
先验证请求，再提交生成任务
- 1. 将 API 密钥保存在服务端，不要放入浏览器、移动端包、日志或公开仓库。
- 2. 按工作流验证 multipart 字段、文件类型、大小、数量、时长和积分。
- 3. 提交 POST 请求，持久化返回的 taskId 与预期扣费。
- 4. 轮询同一路由的 GET 端点，直到 COMPLETED、FAILED 或 CANCELLED。
- 5. 只向任务所属账户交付结果，并按照产品保留规则清理媒体。
计费、隐私与导出
把可验证的边界写入你的集成
API 使用与网页端相同的一次性积分余额。失败生成任务按当前产品规则自动退款；图像试用导出在账户完成首次购买前包含 DeepSwapAI.com 和完整账户邮箱，购买只影响之后新生成的图像，不追溯修改旧文件。上传和生成媒体会在服务器端 24 小时内删除，上传内容不用于训练 AI 模型。
开发者问题
上线前确认这些问题
API 支持 webhook 吗？
目前不支持。提交 POST 后保留 taskId，并在同一工作流路由使用 GET 轮询到终态。
API 是否有官方 SDK？
目前没有发布官方语言 SDK。标准 HTTPS、Bearer 鉴权、multipart 和 JSON 响应可以通过任意服务端 HTTP 客户端调用。
一个图片任务需要多少积分？
一张照片、一个批量输出或一个合照映射人脸当前均为 3 积分；视频和 GIF 按向上取整的秒数及最低费用计算。
API 密钥可以放在前端吗？
不可以。API 密钥必须保存在服务端，并避免写入浏览器包、移动端二进制、日志、分析事件或工单。
用一个代表性任务先验证集成
先用获授权的最小媒体样本测试字段、状态、扣费和结果交付，再扩大到批量或长视频。