参考图人像预处理 · 本地 CPU
seedance2.0 参考图直过
平台提示 「参考图未通过人像审核，请更换参考图」？先把人脸参考图做眼睛遮挡，再拿结果图去 Seedance / 即梦 / 豆包生成。
上传图片或粘贴 URL → 本地检测并遮挡眼睛 → 得到新参考图地址。不调用云端视觉 API；图不过第三方。
- 1上传卡住的参考图
- 2一键遮眼出图
- 3用结果图当新参考图
真实效果（原图 → 结果）
立刻试：把卡审参考图变成可用参考图
遮挡框大小
5
（默认 5≈过审友好；2 更贴眼、10 近整脸）
准备就绪：把被拒的参考图拖进来，或粘贴网络地址。
拖入被拒的参考图
处理后下载 / 复制结果 URL，再回平台当参考图 · jpg / png / webp
接入你的工作流（API）
| 字段 | 说明 |
|---|---|
image |
与 imageUrl 二选一。jpg / png / webp。处理时长边>1600 等比缩小；结果一律 .webp |
imageUrl |
与 image 二选一。http/https 图片 URL；服务端下载后走同一流水线；上限 20MB，下载超时 15 秒 |
detector |
可选。onnx（默认，YuNet 五点）或 haar。省略和 auto 一样：模型可用时用 onnx，否则用 haar。yunet 等同 onnx |
noFace |
可选。1 / true / yes 跳过人脸、全图检眼；省略默认先找脸。只在 detector=haar 时生效 |
singleEye |
可选。每脸只遮一只眼。1 / true / yes 开，0 / false / no 关；省略默认开 |
haarFallback |
可选。仅 detector=onnx。1 / true / yes 时，YuNet 打码后再用 Haar 补漏脸；0 / false / no 关。省略默认关。detector=haar 时忽略 |
size |
可选。遮挡框大小 1–10：2≈眼睛大小，10≈整张脸；默认 5 |
成功响应示例：
调用示例：
原图与结果图按日期目录同 id 映射：
data/in/YYYY-MM-DD/{id}.ext ↔
data/out/YYYY-MM-DD/{id}.webp。
处理时长边超过 1600 会等比缩小；结果一律 WebP。
检测在独立线程排队，默认同时处理 4 张，队列上限 256，满了返回 503。
响应里的 haarFallback 只有在 detector=onnx 且参数打开时才是 true。
queueDepth 是入队时前面已有的张数，timings.queue 是排队等待的毫秒数。
默认保留 30 天（环境变量 RETENTION_DAYS），后台清理，不挡请求。
更完整说明见 docs/API.md。