Image Portrait Generate

Image Portrait Generate

Overview

从参考图（人像/宠物）生成高精度写真，覆盖单人/宠物/多人写真（证件照/形象照/艺术照/发型调整/场景变换）和双人合影合成。支持 2K/4K 分辨率。仅在用户明确要求写真生成或双人合照合成时触发，不用于泛化的“合影”“团体照”闲聊场景。

API Mapping

• 单人/宠物/多人写真（主）：image_gummy_edit_v45
• 单人/宠物写真降级（兜底）：image_mint_portrait_edit_2k
• 双人合影合成：image_groupphoto2_edit
• model 映射：auto（默认）/gummy_pro→v45 / mint_portrait→mint_2k

Dependencies

• meitu-cli: >=2.0.6
• 凭证：CONFIG AKSK → meitu tools update；EXEC AKSK → 实际执行（见根 CONFIG.md）
• 环境变量：MEITU_OPENAPI_TOOL_TASK_MODE=command

> 路径别名：$VISUAL = {OPENCLAW_HOME}/workspace/visual/

Core Workflow

Preflight → Execute → Deliver

Preflight

1. meitu --version ≥ 2.0.6
2. 已用 CONFIG AKSK 跑过 meitu tools update
3. 当前 AKSK = EXEC，MEITU_OPENAPI_TOOL_TASK_MODE=command
4. output_dir：openclaw.yaml → ./output/ ｜else → $VISUAL/output/image-portrait-generate/；mkdir -p

Execute

触发信号 / 路由规则

核心维度：输入图片数 + 合影信号。

| 场景 | 判定关键词 | 图片数 | 路由 | |------|----------|---|------| | 双人合影 | 合影、合照、两个人合成 | 恰好 2 | image_groupphoto2_edit | | 双人合影但不足 2 张 | 合影 | 1 | 提示"请提供两张人像照片" | | 双人合影但超过 2 张 | 合影 | >2 | 取前 2 张 + 告知 | | 单人 / 宠物写真 | 写真、证件照、形象照、发型、宠物写真 | 1 或 >1 | image_gummy_edit_v45 → image_mint_portrait_edit_2k | | 多人写真（3 人+） | 团体照、3 人写真 | 1（多人图） | image_gummy_edit_v45（不降级） | | 意图不明 + 2 张图 | -- | 2 | 默认走单人写真 |

参数定义

| 参数 | 类型 | 必填 | 范围 | 默认 | 说明 | |------|------|------|------|------|------| | image_list | ARRAY[STRING] | 是 | 1–N 张 | -- | 人像/宠物图片 URL 数组 | | prompt | STRING | 是 | -- | -- | 写真描述；缺失时根据上下文自动生成 | | size | STRING | 否 | 2K / 4K | 2K | 输出分辨率（仅 image_gummy_edit_v45 支持） |

API 映射说明：

• image_gummy_edit_v45（主）：image_list[0]→image_url（API 本身支持多人），prompt/size 直传
• image_mint_portrait_edit_2k（降级）：image_list[0]→image_url，prompt 直传
• image_groupphoto2_edit（双人合影）：image_list 数组（必须恰好 2 张），prompt→instruction（非中英文自动翻译为中文）；固定参数 lora_key=multi_duorenhezhao_2k、rsp_media_type=url

证件照 + 指定底色（蓝/白/红）：在 prompt 中写入底色要求（如"蓝色纯色背景证件照"）。

工具调用

meitu image-portrait-generate --image_list [,,...] --prompt "" [--size 2K|4K] --json --download-dir {output_dir} --skill_name skill_image-portrait-generate

错误降级

| 场景 | 处理方式 | |------|------| | image_list 缺失 | 提示"请提供参考图片"，不调用 API | | image_list 中任一图片不可访问 | 返回图片链接无效错误，不重试 | | prompt 缺失 | 根据上下文自动生成 | | 合影但仅 1 张 | 提示"请提供两张人像照片" | | 合影且 >2 张 | 取前 2 张并告知 | | 写真但给 2 张 | 默认走单人写真 | | image_gummy_edit_v45 失败（单人/宠物） | 自动降级至 image_mint_portrait_edit_2k | | image_mint_portrait_edit_2k 失败 | 返回错误 | | image_gummy_edit_v45 失败（多人/3 人+） | 不降级，直接返回错误 | | image_groupphoto2_edit 失败 | 返回错误 | | 未检测到人脸/宠物 | 返回错误：参考图需包含清晰人像或宠物 | | 内容合规拦截 | 直接返回合规提示，不重试、不降级 |

Deliver

• 使用 Preflight 解析的 output_dir
• 从 downloaded_files[0].saved_path 读取已下载文件路径
• mv {downloaded_files[0].saved_path} {output_dir}/{YYYY-MM-DD}_{descriptive}_image-portrait-generate.{ext}

Output

• 格式：image
• 位置：项目 → ./output/，一次性 → $VISUAL/output/image-portrait-generate/

基线 Task ID

见 references/task-id-baseline.md 中对应行。

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: meitu
• Source: meitu/meitu-skills
• License: MIT

Install and usage instructions live in the source repository linked above.