横幅插画生成工具（免费版）

概述

横幅插画生成工具免费版帮助你使用图像生成 API 创建新图像或编辑现有图像。支持 1K/2K/4K 三档分辨率，内置草稿-迭代-终稿三阶段工作流，让你快速迭代不浪费高分辨率配额。

核心能力

核心功能执行

用input_params参数进行配置。

输入: 用户提供核心功能执行所需的指令和必要参数。 处理: 按照skill规范执行核心功能执行操作,遵循单一意图原则。 输出: 返回核心功能执行的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

参数配置与调用

用config_options参数进行配置。

输入: 用户提供参数配置与调用所需的指令和必要参数。 处理: 按照skill规范执行参数配置与调用操作,遵循单一意图原则。 输出: 返回参数配置与调用的执行结果,包含操作状态和输出数据。

• 执行此能力时使用config_options参数,支持修改/重置/导入操作

结果处理与输出

用output_format参数进行配置。

输入: 用户提供结果处理与输出所需的指令和必要参数。 处理: 按照skill规范执行结果处理与输出操作,遵循单一意图原则。 输出: 返回结果处理与输出的执行结果,包含操作状态和输出数据。

• 执行此能力时使用output_format参数,支持导出/保存/转换操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：使用图像生成、API、创建与编辑横幅插、分辨率与草稿迭代、适合个人创作、横幅插画生成工具、免费版、面向个人创作者的、轻量级图像生成与、编辑工具、编辑现有图像、三档分辨率、终稿三阶段工作流等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

场景一：生成博客横幅

为博客文章生成一张横幅图。

# 生成横幅（1K 草稿）
uv run scripts/generate_image.py 
  --prompt "A serene Japanese garden with cherry blossoms, soft morning light, watercolor style" 
  --filename "2026-07-18-blog-banner-draft.png" 
  --resolution 1K

# 满意后生成 4K 终稿
uv run scripts/generate_image.py 
  --prompt "A serene Japanese garden with cherry blossoms, soft morning light, watercolor style" 
  --filename "2026-07-18-blog-banner-final.png" 
  --resolution 4K

场景二：编辑现有图像

对现有照片进行风格化编辑。

# 编辑现有图像
uv run scripts/generate_image.py 
  --prompt "make the sky more dramatic with storm clouds, increase contrast" 
  --filename "2026-07-18-edited-sky.png" 
  --input-image "original-photo.jpg" 
  --resolution 2K

场景三：快速概念图

为产品设计生成快速概念图。

# 1K 快速概念图
uv run scripts/generate_image.py 
  --prompt "minimalist mobile app onboarding screen, pastel colors, flat design" 
  --filename "2026-07-18-concept-onboarding.png" 
  --resolution 1K

快速开始

1. 阅读## 核心能力章节了解skill功能
2. 按## 依赖说明配置环境
3. 执行所需能力对应的命令
4. 参考## 错误处理章节处理异常
5. 查看## FAQ解答常见疑问

# 1. 设置 API Key
export GEMINI_API_KEY="your-api-key"

# 2. 生成新图像
uv run scripts/generate_image.py 
  --prompt "your image description" 
  --filename "output-name.png" 
  --resolution 1K

# 3. 编辑现有图像
uv run scripts/generate_image.py 
  --prompt "editing instructions" 
  --filename "output-name.png" 
  --input-image "path/to/input.png" 
  --resolution 2K

示例

# 分辨率映射
| 用户表述                    | 分辨率 |
|:----------------------------|:-------|
| 未提及 / 1080 / 1080p / 1K  | 1K     |
| 2K / 2048 / 标准 / 中等     | 2K     |
| 高分辨率 / hi-res / 4K / 超清 | 4K     |

# API Key 检查顺序
1. --api-key 参数（用户在对话中提供）
2. GEMINI_API_KEY 环境变量

# 文件命名格式
{yyyy-mm-dd-hh-mm-ss}-{descriptive-name}.png

# 示例
# 2026-07-18-14-23-05-japanese-garden.png
# 2026-07-18-15-30-12-sunset-mountains.png

最佳实践

• 先用 1K 草稿快速迭代 Prompt，锁定方向后再生成 4K 终稿。
• 编辑图像时保持相同的 --input-image，直到满意为止。
• Prompt 包含主题、风格、构图、光照、背景、调色板等要素更精准。
• 编辑时明确「仅修改什么，保持其他不变」，避免意外变化。
• 文件命名包含时间戳与描述，便于后续查找。
• 不要读回生成的图像，仅告知用户保存路径。
• 保留用户的创作意图，仅在 Prompt 明显不足时才重写。

常见问题

Q：免费版支持批量生成吗？ A：免费版面向单张生成与编辑。如需批量生成与模板管理，请考虑 PRO 版本。

Q：免费版支持自定义 Prompt 模板吗？ A：免费版不提供模板保存。如需模板库与复用，请使用 PRO 版本。

Q：API Key 如何获取？ A：通过 --api-key 参数传入，或设置 GEMINI_API_KEY 环境变量。两者都不可用时脚本会报错。

Q：编辑图像时会改变原图吗？ A：不会。编辑会生成新文件，原图保持不变。

Q：支持哪些图像格式？ A：生成输出为 PNG。输入支持 PNG、JPG 等常见格式。

Q：遇到 403 或配额错误怎么办？ A：检查 API Key 是否有效、是否有访问权限、配额是否用尽。尝试更换 Key 或账户。

依赖说明

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
• 操作系统: Windows / macOS / Linux
• Python: 3.9+
• uv: Python 包管理器

依赖详情

API Key 配置

• GEMINI_API_KEY - 图像生成 API 密钥
• 也可通过 --api-key 参数传入
• API Key 仅从环境变量或参数读取，不硬编码

可用性分类

• 分类: MD+EXEC（Markdown指令 + Python脚本执行）
• 说明: 基于Markdown的AI Skill，通过 Python 脚本调用图像生成 API

错误处理

已知限制

• 本地运行，不支持多设备同步
• 当前为免费版本,如需完整功能请升级到付费版获取全部能力