meitu Image Transform
Overview
对已有图片做几何变换（不改变画面内容）。4 类场景：旋转/翻转（-180°~180°）、等比放大（2/4/8 倍）、无损等比缩小、智能构图/画布扩展/尺寸变换（AI outpainting）。关键区分："放大 N 倍/缩小到 800 宽/扩图/改尺寸"走本工具；"放大到 4K"（分辨率目标）走 image-superres-enhance。
API Mapping
- 旋转/翻转：
api_v1_layer_flow_edit_rotate - 等比放大：
image_upscale_equal_proportion_edit - 无损缩小：
image_dldownscaling_edit - 智能构图 / 画布扩展 / 尺寸变换：
image_extension_layer_flow_filter
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
meitu --version≥ 2.0.6- 已用 CONFIG AKSK 跑过
meitu tools update - 当前 AKSK = EXEC，
MEITU_OPENAPI_TOOL_TASK_MODE=command - output_dir：openclaw.yaml →
./output/｜else →$VISUAL/output/image-transform/；mkdir -p
Execute
触发信号 / 路由规则
核心维度：操作意图分支。
| 场景 | 判定关键词 | 路由 |
|---|---|---|
| 旋转 / 翻转 | 旋转、顺时针、逆时针、翻转、镜像 | api_v1_layer_flow_edit_rotate |
| 等比放大（倍数） | 放大 2/4/8 倍、等比放大 | image_upscale_equal_proportion_edit |
| 无损缩小 | 缩小到 xxx、无损缩小 | image_dldownscaling_edit |
| 智能构图 / 画布扩展 / 改比例 / 尺寸变换 | 扩图、改成 16:9、竖版改横版、outpaint、智能构图、重新构图、调整到指定宽高 | image_extension_layer_flow_filter |
路由原则：缩小目标 > 原图 → 自动转 image_upscale_equal_proportion_edit；缩小目标 = 原图 → 直接返回原图。
参数定义
通用：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
image_url |
STRING | 是 | 图片地址 |
api_v1_layer_flow_edit_rotate：
| 参数 | 类型 | 范围 | 默认 | 说明 |
|---|---|---|---|---|
rotate |
NUMBER | -180 ~ 180 | 0 | 旋转角度；超出自动 clamp |
flip_x |
BOOLEAN | true/false | false | 水平翻转 |
flip_y |
BOOLEAN | true/false | false | 垂直翻转 |
image_upscale_equal_proportion_edit：
| 参数 | 类型 | 范围 | 默认 | 说明 |
|---|---|---|---|---|
sr_num |
INTEGER | 2 / 4 / 8 | 2 | 放大倍数；非法值取最近合法值（3→2，6→8） |
image_dldownscaling_edit：
| 参数 | 类型 | 说明 |
|---|---|---|
target_width |
INTEGER | 目标宽度（像素 px，禁止传比例数字） |
target_height |
INTEGER | 目标高度（像素 px，禁止传比例数字） |
- 仅给一边 → 按原图比例计算另一边
- 目标 > 原图 → 自动切
image_upscale_equal_proportion_edit - 目标 = 原图 → 直接返回原图
image_extension_layer_flow_filter：
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
width |
INTEGER | -- | 目标宽度（像素 px，禁止传比例数字） |
height |
INTEGER | -- | 目标高度（像素 px，禁止传比例数字） |
prompt |
STRING | 保持原图风格自然延伸 | 扩展/重构区域 AI 补全描述 |
width/height 必须绝对像素值：用户说"16:9"→按原图尺寸计算像素（例：原图 1024×768，16:9 → width=1024, height=576）；只说"扩图"无具体值 → 默认按 3:4 比例计算。扩展场景目标 < 原图 → 不调用，提示"目标尺寸需大于原图尺寸"。
工具调用
# 旋转
meitu image-transform --image_url <url> --rotate 90 --json --download-dir {output_dir} --skill_name skill_image-transform
# 等比放大
meitu image-transform --image_url <url> --sr_num 4 --json --download-dir {output_dir} --skill_name skill_image-transform
# 缩小
meitu image-transform --image_url <url> --target_width 800 --json --download-dir {output_dir} --skill_name skill_image-transform
# 扩图
meitu image-transform --image_url <url> --width 1920 --height 1080 --json --download-dir {output_dir} --skill_name skill_image-transform
错误降级
| 场景 | 处理方式 |
|---|---|
image_url 缺失 |
提示"请提供需要变换的图片" |
image_url 不可访问 |
直接返回图片链接无效错误，不重试 |
rotate 超出 -180~180 |
自动 clamp |
sr_num 非法 |
取最近合法值 |
downscale 目标 > 原图 |
自动切 image_upscale_equal_proportion_edit |
downscale 目标 = 原图 |
不调用，直接返回原图 |
downscale 只给一边 |
按原图比例计算另一边 |
| 扩图目标 < 原图 | 不调用，提示"目标尺寸需大于原图尺寸" |
| 智能构图/尺寸变换缺 width/height 且无法从比例推算 | 提示"请提供目标宽高或目标比例" |
| 任一 API 调用失败 | 重试 1 次，仍失败返回错误 |
| 内容合规拦截 | 直接返回合规提示，不重试、不降级 |
| 同时要旋转 + 扩图 | 建议分步操作：先旋转再扩图 |
Deliver
- 使用 Preflight 解析的 output_dir
- 从
downloaded_files[0].saved_path读取已下载文件路径 mv {downloaded_files[0].saved_path} {output_dir}/{YYYY-MM-DD}_{descriptive}_image-transform.{ext}
Output
- 格式：image
- 位置：项目 →
./output/，一次性 →$VISUAL/output/image-transform/
基线 Task ID
见 references/task-id-baseline.md 中对应行。