Text To Image（文生图）

Overview

从文字描述从零生成全新图片（无底图），参考图仅作风格/氛围补充而非内容主体。涵盖 2 类场景：

1. 通用文生图 / 多图参考融合：创意概念图、插画、风格混搭、快速出图；支持 image_list 多图参考融合；发散/多样/速度快的默认通道。
2. 商业级高品质生成：宣传视觉/封面、电商海报/营销 Banner、产品场景图、文字渲染（信息图/海报文字）、写实/电影截图风格；文本理解深、文字渲染准、高分辨率；不支持 image_list。

含人物/角色/肖像描述的文生图（人物封面、概念图、插画含人物）由本工具承接。不处理：基于已有图片编辑/修改、参考图驱动的创作（参考图为主要内容来源）、已提供参考图的高保真人像/宠物写真/证件照、海报排版设计、风格迁移、视频生成、搜图、画质提升/超分。

API Mapping

model 映射：

• auto（默认）/ 不传 → 按路由规则决策
• gummy → imagegummygenerate
• pralinepro → imagepralinecreatev2
• nougat → imagenougatcreate（仅外部显式指定触发；路由不识别）
• 指定 model 调用失败时，仍按降级链继续重试

Dependencies

• meitu-cli: >=2.0.6
• 凭证：CONFIG AKSK → meitu tools update；EXEC AKSK → 跑命令（见根 CONFIG.md）
• 环境变量：MEITUOPENAPITOOLTASKMODE=command

Core Workflow

Preflight → Execute → Deliver

Preflight

1. meitu --version ≥ 2.0.6
2. meitu auth verify --json
3. 确认 registry 含 text-to-image
4. 解析 output_dir：openclaw.yaml → ./output/；else → ~/.openclaw/workspace/visual/output/text-to-image/

Execute

触发信号 / 路由规则

决策顺序：

1. 有 imagelist → 强制 imagegummygenerate（praline 不支持 imagelist）
2. 无 imagelist：商业/宣传/文字渲染/写实电影风 → imagepralinecreatev2；否则 → imagegummygenerate（默认）

参数定义

通用参数：

imagegummygenerate 额外参数：

imagepralinecreate_v2 额外参数：

imagepralinecreate_2（兜底）：

imagenougatcreate（显式模型）：

说明：imagelist 与 ratio 互斥；outputformat 由 combo-tool 内部固定为 jpeg，不对外暴露。

工具调用

创意 / 默认：

meitu text-to-image \
  --skill_name skill_text-to-image \
  --prompt "{image_description}" \
  --size 2K \
  --json --download-dir {output_dir}

多图参考融合：

meitu text-to-image \
  --skill_name skill_text-to-image \
  --prompt "{image_description}" \
  --model gummy \
  --image_list "{ref1}" --image_list "{ref2}" \
  --json --download-dir {output_dir}

商业级高品质（带比例）：

meitu text-to-image \
  --skill_name skill_text-to-image \
  --prompt "{image_description} Aspect ratio 16:9" \
  --model praline_pro \
  --ratio 16:9 --size 2K \
  --json --download-dir {output_dir}

错误降级

Deliver

解析 --json：

• ok: true → downloadedfiles[0].savedpath 为本地图片
• ok: false → 输出 code + hint

落盘：mv {file} {outputdir}/{YYYY-MM-DD}{descriptive-name}.jpg

Output

• 格式: JPEG（combo-tool 内部固定）
• 命名: {YYYY-MM-DD}_{descriptive-name}.jpg
• 位置: 项目 → ./output/；一次性 → ~/.openclaw/workspace/visual/output/text-to-image/

基线 Task ID

见根目录 references/task-id-baseline.md 中 text-to-image 条目。