mcpField
I
image-style-transfer

image-style-transfer

github.com/meituクリエイティブ・メディア36129 回インストール9 週間前に更新
リポジトリ

image-style-transfer について

既存画像を単一画像からスタイル変換するほか、別の参照画像を使ったスタイル転送にも対応するスキルです。画像の枚数とスタイルに応じて処理先を選び、失敗時には代替経路を使います。

主な機能

  1. 011枚の画像に5種類のプリセットを適用
  2. 021枚の画像を一般的なスタイルに変換
  3. 03参照画像からスタイルを転送
  4. 04画像枚数とスタイルで処理先を選択
  5. 05失敗時の代替処理経路

活用シーン

  1. 01写真をちびキャラ風や絵文字風に変換
  2. 02画像を水彩画、油絵、アニメ風に変換
  3. 03元画像と参照画像を使ったイラストのスタイル転送

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/meitu/meitu-skills --skill image-style-transfer

インストール後、Claude Code で/image-style-transferを入力して読み込まれたか確認します。

詳細

プロジェクトの README より

Image Style Transfer

Overview

对已有图片做风格化处理，两类能力：单图风格化（Q 版/emoji/史努比/molly/动森 5 种预设 + 其他通用风格）和双图参考风格迁移（原图 + 风格参考图，覆盖水彩/油画/动漫/3D 插画类）。

API Mapping

  • 预设风格化（chibi/emoji/snoopy/molly/动森 5 种）：formula_group_creative_play
  • 单图通用风格化（主）：image_praline_edit_v2
  • 单图通用风格化（降级）：image_praline_edit_2
  • 参考图风格迁移：image_mint_styletransfer
  • 双图兜底：image_praline_edit_v2
  • 工具内兜底：image_mint_edit
  • Nougat 高质量（外部显式指定）：image_nougat_edit（路由不识别；ratio 原生 11 枚举；size 内部常量 2K；quality 由 API 内部默认 Medium 不对外暴露）
  • model 映射：auto（默认）/praline_pro→v2 / praline_lite→edit_2 / mint_style→styletransfer（必须同时提供 style_image_url，单图禁止指定）/ mint_edit→mint / nougat→nougat_edit（外部显式指定触发）

可选参数：--model <auto|praline_pro|praline_lite|mint_style|mint_edit|nougat>、--ratio <auto|1:1|...|21:9>（仅 model=nougat 路径生效，其他静默忽略）

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-style-transfer/；mkdir -p
Execute

触发信号 / 路由规则

核心维度：输入图片数量。

输入图片数条件路由
1 张prompt 含 chibi（Q版）/ emoji / snoopy / molly / 动森formula_group_creative_play
1 张其他风格（油画/水彩/动漫/3D/卡通/像素等）image_praline_edit_v2
2 张请求为插画类风格迁移image_mint_styletransfer
2 张请求为非插画类风格迁移image_praline_edit_v2

路由原则：formula_group_creative_play 仅限 1 张图 + 5 种预设；image_mint_styletransfer 仅限 2 张图 + 插画类；图片数 >2 仅取前 2 张。

参数定义

参数类型必填说明
image_urlARRAY[STRING]是图片地址列表。1 张=原图；2 张=[原图, 风格参考图]，顺序固定
promptSTRING是用户目标风格描述，用于效果检索和兜底处理
modelSTRING否auto / praline_pro / praline_lite / mint_style / mint_edit / nougat
ratioSTRING否仅 model=nougat 路径生效；其他 model 静默忽略

API 映射说明：

  • formula_group_creative_play：image_url[0] + effect_id（effect_id 由工具内部根据 prompt 风格关键词自动匹配，不暴露）
  • image_mint_styletransfer：image_url[0]（原图）+ image_url[1]（风格参考图）+ prompt
  • image_praline_edit_v2：按兜底工具实际参数要求映射

工具调用

meitu image-style-transfer --image_url <origin>[,<style_ref>] --prompt "<style desc>" --json --download-dir {output_dir} --skill_name skill_image-style-transfer

错误降级

场景处理方式
formula_group_creative_play 调用失败重试 1 次，仍失败走 image_praline_edit_v2
image_praline_edit_v2 调用失败（单图）降级至 image_praline_edit_2
image_praline_edit_2 调用失败（单图）降级至 image_mint_edit
image_mint_edit 调用失败（单图）返回错误
image_mint_styletransfer 调用失败重试 1 次，仍失败走 image_praline_edit_v2
image_praline_edit_v2 调用失败（双图）降级至 image_praline_edit_2
image_praline_edit_2 调用失败（双图）降级至 image_mint_edit
image_mint_edit 调用失败（双图）返回错误
2 张图但非插画类风格走 image_praline_edit_v2
1 张图但不属于 5 种预设走 image_praline_edit_v2
图片数 >2仅取前 2 张按双图分支处理
写实人像写真 / 视频创意生成直接拒绝，不调用任何 API
内容合规拦截直接返回合规提示，不重试
Deliver
  • 使用 Preflight 解析的 output_dir
  • 从 downloaded_files[0].saved_path 读取已下载文件路径
  • mv {downloaded_files[0].saved_path} {output_dir}/{YYYY-MM-DD}_{descriptive}_image-style-transfer.{ext}

Output

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

基线 Task ID

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

コメント

Markdown 対応