meitu 图生图（image-edit）
Overview
对已有图片施加内容编辑或基于参考图创作全新图片（必须有底图）。覆盖 5 类场景：电商产品出图（白底/场景/多角度/带文字）、人像编辑（人脸/妆容/发型/姿态）、多图与一致性编辑、通用编辑（替换/添加/构图）、参考图创作（创意视觉稿/名片/封面）。涉及文字添加/替换时目标文字内容保持原样不翻译；"IP"指角色图案而非文字。
执行前应让用户清楚知道：本 Skill 会读取本地 Meitu 凭证、调用 meitu image-edit，并把输入图片、提示词及生成结果发送到/写回外部服务与本地输出目录。
API Mapping
- 人像编辑：
image_gummy_edit_v45 - 多图/一致性/通用/电商/参考图创作（主）：
image_praline_edit_v2 - 通用编辑（降级）：
image_praline_edit_2 - 工具内兜底：
image_mint_edit - Nougat 高质量（外部显式指定）：
image_nougat_edit（路由不识别；image_list 最多 10 张；不支持 output_format；size 内部常量 2K；quality 由 API 内部默认 Medium 不对外暴露）
model 映射：auto（默认按路由）/gummy_pro→gummy/praline_pro→v2/praline_lite→2/mint_edit→mint/nougat→nougat_edit（外部显式指定触发）
Dependencies
- meitu-cli:
>=2.0.6（npm install -g meitu-cli@latest） - 凭证：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
meitu --version≥ 2.0.6（否则npm install -g meitu-cli@latest）- 确认已跑过
meitu tools update（用 CONFIG AKSK） - 当前 AKSK = EXEC，且
MEITU_OPENAPI_TOOL_TASK_MODE=command - 解析 output_dir：openclaw.yaml →
./output/｜else →$VISUAL/output/image-edit/；mkdir -p
Execute
触发信号 / 路由规则
核心判断维度：电商产品出图 → 前置判断（参考图创作 / 多图）→ 单图场景分类。
决策顺序：
0. 前置 0 — 电商产品出图：产品图 + 电商意图（白底/主图/场景/多角度/促销文字） → image_praline_edit_v2
- 前置 A — 参考图创作：有参考图 + 生成全新图意图 →
image_praline_edit_v2 - 前置 B — 多图输入：
image_list≥ 2 张 →image_praline_edit_v2（强制使用image_list） - 单图场景（优先级：人像 > 一致性 > 通用）：
- 人像（人脸/表情/妆容/发型/肤色/姿态/五官） →
image_gummy_edit_v45 - 一致性（商品微调/保持主体/已有图片文字替换） →
image_praline_edit_v2 - 通用（替换/添加/构图） →
image_praline_edit_v2
- 人像（人脸/表情/妆容/发型/肤色/姿态/五官） →
参数定义
通用参数（所有 API 共用）：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
image_list |
ARRAY[STRING] | 是 | 图片地址列表，所有 API 统一使用。缺失 → 提示"请提供图片" |
prompt |
STRING | 是 | 编辑描述。文字添加/替换场景目标文字保持用户原文不翻译；"IP"指图案/角色而非文字 |
image_praline_edit_v2 额外参数：
| 参数 | 类型 | 必填 | 范围 | 默认值 | 说明 |
|---|---|---|---|---|---|
ratio |
STRING | 否 | auto/1:1/2:3/3:2/3:4/4:3/4:5/5:4/9:16/16:9/21:9 | auto | 特殊比例需在 prompt 结尾写 Aspect ratio x:y |
size |
STRING | 否 | 1K/2K/4K | -- | 输出分辨率 |
output_format |
STRING | 否 | jpeg/png/webp | jpeg | 输出格式 |
model 参数（可显式指定绕过 auto 路由）：gummy_pro（人像）/praline_pro（通用）/praline_lite（降级）/mint_edit（兜底）/nougat（高质量，外部显式指定触发，路由不识别）。
工具调用
meitu image-edit \
--skill_name skill_image-edit \
--image_list <url1,url2> \
--prompt "<edit_description>" \
--json \
--download-dir {output_dir}
可选：--ratio 1:1 --size 2K --output_format png --model praline_pro
错误降级
| 场景 | 处理方式 |
|---|---|
image_gummy_edit_v45 失败 |
重试 1 次 → 降级 image_praline_edit_v2，后续按 v2→2→mint |
image_praline_edit_v2 失败 |
重试 1 次 → 降级 image_praline_edit_2（多图取 image_list[0]） |
image_praline_edit_2 失败 |
重试 1 次 → 降级 image_mint_edit |
image_mint_edit 失败 |
返回错误 |
| 内容合规拦截 | 返回合规提示，不重试、不降级 |
| 多图 + 人像意图 | 强制走 v2（gummy 仅支持单图），建议拆分单张处理 |
| prompt 含目标文字 | 文字内容保持原样、不翻译 |
| prompt 含"IP" | 保留"图案/角色"语义，不得转为"文字" |
Deliver
- 直接使用 Preflight 解析的 output_dir
- 从
downloaded_files[0].saved_path读取已下载文件路径 mv {downloaded_files[0].saved_path} {output_dir}/{YYYY-MM-DD}_{descriptive}_image-edit.{jpeg|png|webp}
Output
- 格式：JPEG（默认）/PNG/WebP（由
output_format决定） - 命名：
{YYYY-MM-DD}_{descriptive}_image-edit.jpg - 位置：项目 →
./output/，一次性 →$VISUAL/output/image-edit/
基线 Task ID
见 references/task-id-baseline.md 中对应行。