Image Poster Generate

Image Poster Generate

Overview

文/图生海报，多风格多尺寸，支持海报编辑、文字修改、换背景。覆盖促销海报、活动宣传图、广告 Banner、社交媒体配图、品牌推广图。

API Mapping

• 海报生成：image_poster_generate
• model 值（首字母大写，与 image-edit 的 snake_case 命名空间不同）：Praline_2（默认）/ GummyV4.5 / PralineV2 / Gummy / 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-poster-generate/；mkdir -p

Execute

触发信号 / 路由规则

核心维度：参数齐全 + 海报场景命中 + model 选型。

| 场景 | 判定关键词 | 路由 | |------|----------|------| | 文生海报（无参考图） | 海报、宣传图、Banner | image_poster_generate | | 图生海报 / 海报编辑（有 image_list） | 修改这张海报、参考海报 | image_poster_generate + image_list |

model 选型（首字母大写，与 image-edit 的 snake_case 命名空间不同）：默认 Praline_2（综合），写实人像 → GummyV4.5，高创意 → PralineV2，通用人像 → Gummy，特殊风格 → Nougat。

参数定义

| 参数 | 类型 | 必填 | 范围 | 默认 | 说明 | |------|------|------|------|------|------| | prompt | STRING | 是 | -- | -- | 海报描述。缺失 → 提示"请描述您想要的海报内容" | | model | STRING | 否 | Gummy / Nougat / PralineV2 / GummyV4.5 / Praline2 | Praline2 | 模型选择（注意首字母大写，区别于 image-edit） | | image_list | ARRAY | 否 | -- | -- | 参考图片 URL 数组 | | ratio | STRING | 否 | auto / 1:1 / 1:3 / 3:1 / 2:1 / 1:2 / 3:2 / 2:3 / 4:3 / 3:4 / 4:5 / 5:4 / 9:16 / 16:9 / 10:16 / 16:10 / 21:9 | auto | 宽高比 | | size | STRING | 否 | auto / 1K / 2K / 4K / 512 | auto | 分辨率 | | output_format | STRING | 否 | jpeg / png / webp | png | 输出格式 | | enhance_prompt | BOOLEAN | 否 | true / false | false | 是否优化 prompt（描述 " [--model Praline2] [--ratio 9:16] [--size auto] [--imagelist ] --json --download-dir {outputdir} --skillname skill_image-poster-generate

**错误降级**

| 场景 | 处理方式 |
|------|------|
| `prompt` 缺失 | 提示"请描述您想要的海报内容" |
| `model` 无效 | 回退至默认 `Praline_2` |
| `ratio` 超出范围 | 选择最接近可选值，或回退 auto |
| `size` 超出范围 | 回退至 auto |
| `image_list` 中图片 URL 无效 | 不重试，提示"请提供有效图片链接" |
| `image_poster_generate` 调用失败 | 重试 1 次，仍失败返回错误 |
| 超时（1200s） | 重试 1 次，仍超时返回错误 |
| 内容合规拦截 | 直接返回合规提示，不重试 |
| 用户描述 <15 字 | 建议开启 `enhance_prompt=true` |

### Deliver

- 使用 Preflight 解析的 output_dir
- 从 `downloaded_files[0].saved_path` 读取已下载文件路径
- `mv {downloaded_files[0].saved_path} {output_dir}/{YYYY-MM-DD}_{descriptive}_image-poster-generate.{ext}`

## Output

- **格式**：PNG（默认）/ JPEG / WebP
- **位置**：项目 → `./output/`，一次性 → `$VISUAL/output/image-poster-generate/`

## 基线 Task ID

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

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [meitu](https://github.com/meitu)
- **Source:** [meitu/meitu-skills](https://github.com/meitu/meitu-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.