未检测到人脸
使用能看清眼睛、鼻子、嘴和大部分下颌的原始画面，减少过度裁剪、模糊、阴影、反光、头发、手、口罩和极端侧脸。
AI 换脸故障排查
换脸不成功？先找到失败发生在哪一步
选择工作流和最后一个确定成功的阶段。决策树会把上传验证、账号校验、排队状态、终止失败和结果质量分开，避免用错误方法反复重试。
失败阶段地图
从最后一个确定成功的阶段开始
上传被拒绝、任务已接受、任务终止失败和已完成但效果不满意是不同问题，混在一起处理只会浪费重试。
| 看到的情况 | 第一步 | 不要这样做 |
|---|---|---|
| 创建任务前上传被拒绝 | 先用对应预检核对真实编码格式、大小、数量和时长，再选择新媒体。 | 不要只改扩展名或反复放大同一个文件；要修正真实编码内容。 |
| 登录、邮箱验证、积分或已有任务阻止提交 | 登录同一账号，完成邮箱验证，对比页面显示的所需积分与余额，并等待已有生成结束。 | 已有任务进行时不要连续点击生成。 |
| 任务处于 PENDING 或 PROCESSING | 打开任务历史，等待已接受任务变成 COMPLETED 或 FAILED，再决定是否重试。 | 刷新或短暂断网后不要创建重复任务。 |
| 任务已经 FAILED 或显示可操作错误 | 读取任务错误，只改变错误指出的条件：人脸可见度、内容审核、文件有效性、请求频率、超时或临时服务状态。 | 没有终止错误和明确修改时，不要用完全相同的输入连续重试。 |
| 任务完成，但结果看起来不对 | 先固定目标图，只改变一项参考图变量：清晰度、角度、表情、光线或遮挡。 | 代表样本未通过检查前，不要扩大到整批图片或长视频。 |
视觉问题
根据可见缺陷只改变一个变量
身份模糊或不像
使用更近、更清晰的参考图和压缩最少的目标原图；放大缩略图不能恢复身份细节。
眼睛、嘴或下颌变形
先缩小参考图和目标图的姿势、表情差异，不要先改分辨率或一次调整全部设置。
换错了人物
返回合照映射，核对每一个编号目标和参考图，不要假定从左到右就是映射顺序。
视频或 GIF 闪烁
找到第一个异常帧，记录从那里开始出现的转头、模糊、遮挡、光线变化、镜头切换或过小人脸。
任务与积分边界
比较余额前先确认任务状态
接受任务前
缺少输入、格式不支持、超出限制、邮箱未验证或积分不足，都可能在任务被接受前阻止提交。
任务已接受
五种换脸工作流先创建 PENDING 积分记录，只有任务成功结算时才减少账号余额。
任务失败
FAILED 换脸任务会把待处理积分记录标为失败，而不是减少余额。提交替代任务前先核对历史和余额。
排查常见问题
再次尝试前的直接答案
为什么检测到人脸后结果仍可能不好？
检测只代表找到了类似人脸的区域，不能证明身份细节足够、姿势兼容、边界清楚或动态稳定。
任务还在排队时要重新提交吗？
不要。先查看任务历史并等待 COMPLETED 或 FAILED。重复任务会增加等待，也会让余额更难判断。
失败的换脸任务会扣积分吗？
当前五种换脸工作流都在成功结算时减少余额；失败任务会把待处理积分记录标为失败。
如何解决“未检测到人脸”？
使用人脸更大、更清晰、遮挡更少的原图，确保眼睛、鼻子、嘴和下颌可见，避免极端侧脸和反复放大缩略图。
这个决策树会检查我的文件或任务吗？
不会。它只组合你选择的工作流和现象，不读取文件、不调用 API、不查询账号、不检测人脸，也不预测质量。
证据边界
依据当前 DeepSwapAI 验证与结算路径核对
产品团队核对了五种公开工作流限制、账号要求、生成锁、PENDING 到终止状态、成功后扣费、失败积分记录处理以及公开输入和质量指南。这里不声称供应商状态、完成时间、准确率或保证修复。 查看验证方法
确认失败阶段后再重试
选择准确工作流，核对页面显示的限制与积分，并且一次只改变一个输入条件。