SuperAPI AI 工具集

image-face-swap

设计与创作

查看项目

更新于 10-16 06:46

技能介绍

用途:双图换脸/换头合成,把源图人脸替换到目标场景图上,保留目标图的构图、身体和背景,并自动进行肤色融合与光影匹配,适用于角色扮演、把自己的脸放到另一张图上、趣味合成等场景。一次只换一张脸,仅支持图片,不支持视频换脸。

主要能力:调用 Meitu OpenAPI 的 image_face_swap 接口完成合成。参数包括 head_image_url(人脸源图 URL,必填)、sence_image_url(场景底图 URL,必填,保留构图/身体/背景)、prompt(附加提示词,必填,缺失时提示描述换脸效果要求)。

使用方式:依赖 meitu-cli >= 2.0.6,可用 npm install -g meitu-cli@latest 安装;需配置 Meitu 凭证(CONFIG AKSK 用于 meitu tools update,EXEC AKSK 用于实际执行),并设置环境变量 MEITU_OPENAPI_TOOL_TASK_MODE=command。执行前需确认 meitu --version ≥ 2.0.6、已运行 meitu tools update、当前 AKSK 为 EXEC。输出目录解析:存在 openclaw.yaml 时为 ./output/,否则为 $VISUAL/output/image-face-swap/($VISUAL = {OPENCLAW_HOME}/workspace/visual/),并需 mkdir -p。调用命令为 meitu image-face-swap --skill_name skill_image-face-swap --head_image_url <head_url> --sence_image_url <sence_url> --prompt "<effect_description>" --json --download-dir {output_dir}。结果从 downloaded_files[0].saved_path 读取,并重命名为 {YYYY-MM-DD}_{descriptive}_image-face-swap.jpg。

路由规则:图片不足 2 张时提示补图;超过 2 张取前 2 张并告知;用户明确指定则按指定分配 head/sence,未区分时第 1 张为 head、第 2 张为 sence,"用 B 换到 A" 时 B 为 head、A 为 sence。

限制:执行时会读取 Meitu 凭证、调用本地 meitu CLI,并将两张人脸相关图片发送到 Meitu OpenAPI 处理;head 图需包含清晰正脸,侧脸或遮挡严重不阻断调用但效果可能受限;图片链接不可访问、未检测到人脸、内容合规拦截时返回错误且不重试;调用失败重试 1 次后返回错误,不做跨工具兜底。