图片生成与编辑

图片生成技能，可以通过自然语言帮助用户生成图片，通过API易国内代理服务访问，支持Node.js和Python两种运行环境。

使用指引

遵循以下步骤：

第1步：分析需求与参数提取

1. 1. 明确意图：区分用户是需要【文生图】（生成新图片）还是【图生图】（编辑/修改现有图片）。
2. 提示词（Prompt）分析：

- 使用用户原始完整输入：把用户输入的原始完整问题需求描述（原文）直接作为 -p 提示词的主体，避免自行改写、总结或二次创作，防止细节丢失。 - 需要补充时先确认：如果信息不足（例如缺少风格、主体数量、镜头语言、场景细节、文字内容、禁止元素等），先向用户提问确认；用户确认后，再把补充内容以“追加”的方式拼接到原始提示词后。 - 样例： - 用户输入：“帮我生成一张猫的图片，风格要可爱一点。” - 正例说明：直接使用用户输入作为提示词：-p 帮我生成一张猫的图片，风格要可爱一点。 - 反例说明：擅自改写为“生成一张可爱风格的猫的图片”会丢失用户原始输入的细节和语气。 - 如果需要补充细节（例如颜色、背景等），先提问确认：“你希望猫是什么颜色的？背景有什么要求吗？”用户回答后，再追加到提示词中：-p 帮我生成一张猫的图片，风格要可爱一点。猫是橘色的，背景是草地。

1. 3. 关键参数整理：

- Prompt（必需）：提示词分析后的最终提示词（默认=用户原始完整且一致的输入；仅在用户确认后才追加补充信息）。 - Filename（可选）：输出图片文件名/路径(需包含文件随机标识，避免重复)。不传则脚本会自动生成带时间戳的文件名。建议根据内容生成合理文件名（例如 catingarden.png），避免使用通用名。 - Aspect Ratio（可选）：根据用户描述推断比例。例如： - 手机壁纸 -> 9:16 - 电脑壁纸/视频封面 -> 16:9 - 头像 -> 1:1 - 默认若用户未明确不指定图片比例，保持图片比例为空。 - Resolution（可选）： - 默认图片比例使用 2K。 - 仅在极端高清需求或用户指定时使用 4K，并通过友好性提示，提示用户生成较慢，耐心等待。 - 注意：参数值必须大写（1K, 2K, 4K）。

第2步：环境检查与命令执行

1. 1. 检查环境：确认 APIYIAPIKEY 环境变量是否已设置（通常假定已设置，若运行失败再提示用户）。
2. 构建并运行命令：

- 优先尝试 Node.js 版本：如果环境有 Node（node 命令可用），优先使用 scripts/generate_image.js（零依赖，参数与 Python 保持一致）。 - Node 不可用再用 Python 版本：使用 scripts/generate_image.py。

文生图命令模板（优先 Node.js）：
bash
node scripts/generate_image.js -p {prompt} -f {filename} [-a {ratio}] [-r {res}]

图生图命令模板（优先 Node.js）：
bash
node scripts/generateimage.js -p {editinstruction} -i {inputpath} -f {outputfilename} [-r {res}]

（可选）Python 版本命令模板（Node 不可用时）：
bash
python scripts/generate_image.py -p {prompt} -f {filename} [-a {ratio}] [-r {res}]
python scripts/generateimage.py -p {editinstruction} -i {inputpath} -f {outputfilename} [-r {res}]

⏱️ 长时间任务处理策略

1. 任务前提示

执行前必须告知用户：

• - 图片生成已启动，预计需要25秒到5分钟

2. 🎨 最佳实践示例

1. 1. 快速生成场景（1K分辨率）

快速模式：1K分辨率生成，预计30秒内完成

1. 2. 高质量生成场景（2K/4K分辨率）

高质量模式：2K分辨率生成，预计1-4分钟\n⏳ 开始生成... 🔄

第3步：结果反馈

1. 1. 执行反馈：等待终端命令执行完毕。
2. 成功：告知用户图片已生成，并指出保存路径。
3. 失败：

- 若提示 API Key 缺失，请指导用户设置环境变量。 - 若提示网络错误，建议用户检查网络或稍后重试。

命令行使用样例

生成新图片

bash
python scripts/generate_image.py -p 图片描述文本 -f output.png [-a 1:1] [-r 1K]

示例：
bash

基础生成

python scripts/generate_image.py -p 一只可爱的橘猫在草地上玩耍 -f cat.png

指定比例和分辨率

python scripts/generate_image.py -p 日落山脉风景 -f sunset.png -a 16:9 -r 4K

竖版高清图片（适合手机壁纸）

python scripts/generate_image.py -p 城市夜景 -f city.png -a 9:16 -r 2K

（可选）Node.js 版本示例：
bash

基础生成

node scripts/generate_image.js -p 一只可爱的橘猫在草地上玩耍 -f cat.png

指定比例和分辨率

node scripts/generate_image.js -p 日落山脉风景 -f sunset.png -a 16:9 -r 4K

编辑已有图片

bash
python scripts/generate_image.py -p 编辑指令 -f output.png -i path/to/input.png [-a 1:1] [-r 1K]

示例：
bash

修改风格

python scripts/generate_image.py -p 将图片转换成水彩画风格 -f watercolor.png -i original.png

添加元素

python scripts/generate_image.py -p 在天空添加彩虹 -f rainbow.png -i landscape.png -r 2K

替换背景

python scripts/generate_image.py -p 将背景换成海滩 -f beach-bg.png -i portrait.png -a 3:4

（可选）Node.js 版本示例：
bash

修改风格

node scripts/generate_image.js -p 将图片转换成水彩画风格 -f watercolor.png -i original.png

多张参考图（最多14张）

node scripts/generate_image.js -p 参考多张图片融合风格 -i ref1.png ref2.png ref3.png -f merged.png

附加资源

• - 常见使用场景文档：references/scene.md

命令行参数说明

Python 与 Node.js 版本参数保持一致（短参数与长参数等价）。

参数	必填	说明
-p / --prompt	是	图片描述（文生图）或编辑指令（图生图）。保留用户原始完整输入。
-f / --filename

否 | 输出图片路径/文件名；不传则自动生成带时间戳的 PNG 文件名，并写入当前目录。 | | -a / --aspect-ratio | 否 | 图片比例：1:1、16:9、9:16、4:3、3:4、3:2、2:3、5:4、4:5、21:9。 | | -r / --resolution | 否 | 图片分辨率：1K / 2K / 4K（必须大写）。不传则不在请求中指定，由 API 侧决定。 | | -i / --input-image | 否 | 图生图输入图片路径；可传多张（最多 14 张）。传入该参数即进入编辑模式。 |

图片参数说明

aspect_ratio - 图片比例

支持以下10种比例：

比例	方向	适用场景
1:1	正方形	头像、Instagram帖子
16:9

横