技能介绍

人像后期里容易踩的坑

证件照要同一套校色却对应多种规格；磨皮和调色常被混成「瘦脸换脸」；换装若接受任意 prompt，合规和身份一致性都难控。Motu Color Engine 通过托管 API 处理人像，技能侧优先用 scripts/ 里的封装脚本，而不是手写一长串 curl，并在文档里明确：保留身份——只做肤色/质感与亮度关系调整，不把服务描述成瘦身、改脸型或换脸。

技能如何组织工作流

环境变量 MCE_API_BASE（默认 https://mce.motu.art）与 MCE_API_KEY（仅作 X-API-Key）是调用前提；缺 key 时引导用户到账户页自行导出，不要在对话里粘贴完整密钥。按需求选脚本即可：

grade.sh：调色、肤色校正、胶片/商业观感，可附带 crop-spec、背景色与可选 lighting-style
smooth.sh：仅磨皮，不改白平衡与整体调色
portrait-lighting.sh：立体布光（natural_dimension / soft_luminous / studio_definition），只改明暗层次
mask.sh：输出 skin、face、person 等灰度蒙版 PNG
crop.sh / id-pack.sh：按规格裁证件照；id-pack 先生成统一 master 再多规格导出，并带 report.json 合规信息
outfit.sh + outfits.sh：换装只能用目录返回的 outfit-id，拒绝自造 id 或自定义 prompt
headshots.sh：AI 职业照分阶段——参考图校验与预览确认、提交异步任务、再下载候选并可选 light 后处理

处理类接口会扣账户 credits；目录发现不扣费。遇到 402 insufficient_credits 应直接说明，不要无脑重试。

边界与注意点

磨皮只在检测到的皮肤区域内软化毛孔与瑕疵；裁剪是 reposition/pad 到规格，不拉伸压缩面部。换装与证件照套餐若含服装，需对应 API scope（如 outfit:process、id-photo:process）。Headshots 须在用户确认 reference-preview.png 后再冻结参考图；复用人像库与新建项目要区分，勿把多步异步流程合成「一键全自动」。细节参数与错误码见技能内 references/api.md、references/headshots-api.md。