关于 image-generation
介绍如何通过 MassGen 的 generate_media 工具生成和编辑图像,面向使用该工具的用户。支持按 API 密钥自动选择后端,也可指定后端、模型和编辑参数。
主要功能
- 01文本生成图像
- 02按可用密钥自动选择后端
- 03批量并行生成
- 04基于输入图像编辑
- 05通过续写 ID 多轮修改
适用场景
- 01从文本提示生成图像
- 02批量生成多个图像结果
- 03将照片转换为水彩风格
- 04逐轮调整图像中的文字或元素
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ massgen/ massgen --skill image-generation安装后在 Claude Code 中输入/image-generation确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/backends.mdediting.mdextra_params.md详细介绍
图像生成
使用 generate_media 并设置 mode="image" 来生成图像。系统会根据可用的 API 密钥自动选择最佳后端。
快速开始
# Simple text-to-image (auto-selects backend)
generate_media(prompt="A cat in space", mode="image")
# Specify backend and quality
generate_media(prompt="A logo for a coffee shop", mode="image",
backend_type="openai", quality="high")
# Batch generation (parallel)
generate_media(prompts=["sunset over ocean", "mountain landscape", "city at night"],
mode="image", max_concurrent=3)
后端对比
| 后端 | 默认模型 | 优势 | API 密钥 |
|---|---|---|---|
| Google(优先级 1) | gemini-3.1-flash-image-preview(Nano Banana 2) | 速度快、尺寸灵活、图像编辑、多轮生成 | GOOGLE_API_KEY 或 GEMINI_API_KEY |
| OpenAI(优先级 2) | gpt-5.4 | 质量高、透明背景、可通过响应 ID 继续生成 | OPENAI_API_KEY |
| Grok(优先级 3) | grok-imagine-image | 1k 分辨率、可通过已存储的数据 URI 继续生成 | XAI_API_KEY |
| OpenRouter(优先级 4) | google/gemini-3.1-flash-image-preview | 通过单个 API 访问多个模型 | OPENROUTER_API_KEY |
关键参数
| 参数 | 说明 | 示例 |
|---|---|---|
prompt | 图像的文字描述 | "一幅描绘群山的水彩画" |
backend_type | 指定特定后端 | "google"、"openai"、"grok"、"openrouter" |
model | 覆盖默认模型 | "gemini-3-pro-image-preview",适用于工作室级质量 |
quality | 图像质量(OpenAI) | "low"、"medium"、"high"、"auto" |
size | 图像尺寸 | 参见后端参考文档 |
aspect_ratio | 宽高比 | "16:9"、"1:1"、"4:5" |
input_images | 用于图生图编辑的源图像 | ["photo.jpg"] |
continue_from | 多轮编辑的续接 ID | result["continuation_id"] |
图生图编辑
通过提供 input_images 来转换现有图像:
generate_media(
prompt="Make it look like a watercolor painting",
mode="image",
input_images=["photo.jpg"]
)
支持图生图的后端:Google(Gemini)、OpenAI、Grok。如果当前后端不支持,系统会自动选择其他后端。
多轮编辑(续接)
使用 continue_from 逐步优化图像:
# First generation
result = generate_media(prompt="A logo for a coffee shop", mode="image")
# Refine using the continuation ID
result2 = generate_media(
prompt="Make the text larger and add a cup icon",
mode="image",
continue_from=result["continuation_id"]
)
各后端使用不同的续接机制:
- OpenAI:传递
previous_response_id(无状态) - Google Gemini:内存中的聊天存储(LRU,50 项)
- Grok:内存中的数据 URI 存储(LRU,50 项)
续接仅适用于单张图像生成(不适用于批量生成)。
Google:Gemini 与 Imagen
Google 支持两种 API 路径。Gemini(Nano Banana 2)是默认选项,推荐用于大多数场景。 只有在需要高级参考图像编辑功能时才需要使用 Imagen。
- Gemini 模型(
gemini-*):generate_content()— 文生图、通过input_images编辑图像、多轮续接 - Imagen 模型(
imagen-*):generate_images()/edit_image()— 文生图并支持negative_prompt/seed/guidance_scale,以及通过参考图像实现风格迁移、控制编辑和主体一致性
如需工作室级的精准度和文字渲染,请使用:model="gemini-3-pro-image-preview"(Pro 级)。
需要更多控制?
- 各后端的尺寸、质量选项和特性:参见 references/backends.md
- 完整的
extra_params参考:参见 references/extra_params.md - 高级编辑(局部重绘、风格迁移、控制、主体):参见 references/editing.md
评论
支持 Markdown