SuperAPI AI 工具集

meitu-image-adapt

设计与创作

查看项目

更新于 10-16 00:23

技能介绍

用途:将用户图片智能适配到指定目标宽高(像素),保持主体比例不变形、内容完整不丢失,背景自然延展无接缝。核心依靠 meitu image-transform 的画布扩展能力。

依赖与环境:需 meitu-cli >= 2.0.6,安装命令 npm install -g meitu-cli@latest。凭证优先使用环境变量 MEITU_OPENAPI_ACCESS_KEY / MEITU_OPENAPI_SECRET_KEY,或预置文件 ~/.meitu/credentials.json;如需人工初始化可执行 meitu config set-ak --value "..." 与 meitu config set-sk --value "..."(会写入本地文件)。验证命令:meitu auth verify --json。路径别名 $VISUAL = {OPENCLAW_HOME}/workspace/visual/。

主要能力与流程:Preflight → Execute → Deliver。Preflight 检查版本、凭证,判断项目模式(cwd 有 openclaw.yaml)或一次性模式,并确定输出目录(项目为 ./output/,否则为 $VISUAL/output/meitu-image-adapt/)。Execute 收集输入(image 必填,接受 URL 或本地 .jpg/.jpeg/.png/.webp;width 默认 1080、height 默认 1920),按优先级解析目标尺寸:明确像素直接使用;平台名查 references/platform-presets.md(如小红书竖版封面 1080×1440、抖音竖版封面 1080×1920、微信公众号头图 900×383、朋友圈 1080×1080、B站封面 1920×1080、淘宝主图 800×800);比例(如 16:9)则保证输出覆盖原图全部像素、不裁切;未指定则默认 1080×1920。调用前预检原图可访问、目标尺寸在 100-8192 范围、与原图差异 ≥5%、单方向延展不超过原图 4 倍。

调用方式:meitu image-transform --skill_name skill_meitu-image-adapt --image_url "{image}" --target_width {width} --target_height {height} [--prompt "{extend_prompt}"] --json --download-dir "{output_dir}"。成功时从 downloaded_files[0].saved_path 取本地路径;失败先检查原始字段 code、hint、error_name、action_url 再归类处理。extend_prompt 仅在用户明确描述扩展区域内容时提供。

错误降级:L1 调整到最近标准比例(16:9、9:16、4:3、3:4、1:1);L2 缩小目标尺寸至长边 2048px 内重试;L3 分步适配;L4 连续 2 次失败则停止报错。常见错误码包括 ORDER_REQUIRED(余额不足)、CREDENTIALS_MISSING(AK/SK 未配置)、INVALID_IMAGE(图片不可读)。

交付与输出:文件按 {date}_{描述性名称}.{ext} 命名,格式与原图一致(PNG/JPEG/WEBP),尺寸为用户指定宽高。

限制:不提供时可省略 extend_prompt 由默认扩图路径完成;单方向过度延展可能质量下降;其他收费与价格信息暂未提供。