mcpField
I
image-generation

image-generation

github.com/hyperfx-ai创意与媒体107192 次安装4 天前更新
代码仓库

关于 image-generation

image-generation 是通过 Hyper MCP 的 images_generate 工具创建和编辑图像的技能。它支持参考图合成、模型选择，以及用于产品拍摄和电商商品页的高级工作流。

主要功能

  1. 01文生图
  2. 02基于参考图编辑
  3. 03多图合成
  4. 04选择模型、宽高比和质量
  5. 05产品与商品页图像工作流

适用场景

  1. 01生成广告活动概念图
  2. 02依据参考图制作品牌化合成图
  3. 03制作产品拍摄或商品页图组

MCP 相关

需要连接 Hyper MCP 以使用 images_generate 工具。技能介绍了通过 MCP 客户端或 Hyper CLI 调用工具的方法。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/hyperfx-ai/marketing-skills --skill image-generation

安装后在 Claude Code 中输入/image-generation确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
image-prompting.md
marketplace-cards.md
product-photoshoot.md

详细介绍

图像生成

使用 images_generate 工具生成图像。它支持文本生成图像、 图像生成图像（传入 reference_images）以及多图合成。默认情况下 （model="auto"），它会为请求选择最合适的模型；设置 model 可指定模型。

要求

本技能假设已将 Hyper MCP 连接到你的 Agent，以便使用 images_generate 工具。若要制作符合品牌形象的广告创意， 还必须在 Hyper 集成中配置 Firecrawl。

如何运行本技能中的工具

本技能中的每个工具都以其规范名称命名。请使用当前界面提供的调用方式运行：

界面查找工具运行工具
MCP 客户端（Claude、Cursor、Codex、ChatGPT）search("<what you want to do>")，然后执行 describe("<name>")call("<name>", {...})
Hyper CLIhyperai search "<what you want to do>"，然后执行 hyperai describe <name>hyperai call <name> --json '{...}'

如果找不到工具，说明对应的集成未连接或未为工作区启用：请停止操作，并告知用户需要连接哪个集成。

调用格式

images_generate(
    requests=[{"id": "ad1", "prompt": "A polished SaaS ad, clean composition"}],
    aspect_ratio="16:9",     # "1:1" (default), "9:16", "16:9", "4:5", "5:4", "2:3", "3:2", "3:4", "4:3", "21:9"
    quality="standard",      # "draft" | "standard" | "high"
    n=1,                      # 1-4 images per request
    model="auto",            # see "Choosing a model" below
)
  • **图像生成图像／品牌参考：**在请求中提供文件： requests=[{"prompt": "Compose into a gift basket", "reference_images": ["file1", "file2"]}]。
  • **可复现的输出：**传入 seed=...。
  • **基于真实世界搜索生成内容：**传入 use_search=True。
  • 请勿展示图像 URL——它们会自动在聊天中呈现。

选择模型

默认选择 model="auto" 即可。只有任务明确需要特定模型时才覆盖默认值：

任务model
初步构思／快速广告创意构思／日常生成gpt-image-2.5-flare
基于参考图像进行精准编辑和品牌构图、制作生产级创意gpt-image-2.5-sunburst
低成本迭代、图像生成图像、最宽的纵横比（新增 1:4、1:8、4:1、8:1）nano-banana
图像中包含可读文本（海报、标签、信息图），或基于搜索的场景nano-banana-pro
产品摄影、材质／织物还原度、精准空间纵深seedream-4.5

各模型的提示词编写技巧，请参阅 references/image-prompting.md。

品牌／网站广告创意——先提取品牌信息

如果用户提供了网站 URL，并希望制作符合品牌形象的创意：

  1. 使用该 URL 调用 firecrawl_branding_extract → 返回品牌颜色、字体、 个性／语气以及已保存的图像文件（徽标、网站图标、og_image）。
  2. 可选择调用 firecrawl_urls_scrape，并传入 formats=["screenshot"] 获取视觉参考。
  3. 使用实际的十六进制颜色、字体名称和语气编写提示词，并将徽标的 file_id 传入 reference_images。

品牌信息结果中的 file 字段是 JSON 数据文件，不是图像——切勿将其作为参考图像传入。 只有 logo.file_id 和 images.*.file_id 是可用的图像。

更高级别的工作流

对于多镜头产品或电商平台相关任务，优先使用工作流工具——它们能保留 产品特征并返回结构化结果：

  • images_product_photoshoots_create — 多镜头产品摄影（影棚、 生活方式、主视觉、轮播图、广告套件）。请参阅 references/product-photoshoot.md。
  • images_marketplace_cards_create — 电商平台商品图片组（Amazon 主图 + 副图、A+ 模块、Shopify）。请参阅 references/marketplace-cards.md。

提醒

  • 请勿向用户展示图像 URL——它们会自动在聊天中显示。
  • 除非用户要求逐字生成，否则请完善含糊的提示词。
  • 根据用途（社交媒体、印刷、网页）匹配 aspect_ratio。
  • 生产用途请使用 quality="high"；迭代时使用 "draft"／"standard"。
  • 生成的 file_id 可在后续调用中作为 reference_images 重复使用。
  • 制作网站品牌相关内容时，请在生成前调用 firecrawl_branding_extract。

评论

支持 Markdown