mcpField
I
imagen

imagen

github.com/sickn33创意与媒体48.7k80 次安装1 天前更新
代码仓库

关于 imagen

imagen 是供 Claude Code 使用的图像生成技能，通过 Google Gemini API 根据文本提示生成 PNG 并返回文件路径。适用于界面素材、文档插图和概念可视化；调用前需确认模型兼容性、授权与费用。

主要功能

  1. 01通过文本提示生成图像
  2. 02将生成结果保存为 PNG
  3. 03可指定模型、尺寸和输出路径
  4. 04使用 Python 标准库辅助脚本
  5. 05检查响应并验证 PNG 标记

适用场景

  1. 01为前端页面生成主视觉或占位图
  2. 02为文档生成架构示意图
  3. 03制作头像、图标或界面素材

安装

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

$npx skills add https://github.com/sickn33/agentic-awesome-skills --skill imagen

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

包含的文件

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

UPSTREAM-NOTICE.md
UPSTREAM-LICENSE.txt
scripts/
generate_image.py

详细介绍

Imagen - AI 图像生成技能

概述

此技能捆绑了经过审核的标准库辅助工具，可用于明确选择且受支持的 Gemini 图像模型；授权调用前，必须检查模型可用性和定价。它可在任何 Claude Code 会话中无缝创建图像——无论你是在构建前端 UI、编写文档，还是需要以视觉方式呈现概念。

跨平台：适用于 Windows、macOS 和 Linux。

何时使用此技能

在实际宿主的图像工具工作流和授权的服务提供商范围内使用：

  • 用户请求生成图像（例如“生成一张……的图像”“创建一张图片……”）
  • 前端开发需要占位图或实际图像
  • 文档需要插图或示意图
  • 将概念、架构或想法可视化
  • 创建图标、徽标或 UI 资源
  • 任何适合使用 AI 生成图像的任务

工作原理

  1. 接收描述所需图像的文本提示词
  2. 使用图像生成配置调用 Google Gemini API
  3. 将生成的图像保存到指定位置（默认为当前目录）
  4. 返回文件路径，供项目使用

用法

Python（跨平台 - 推荐）
# Basic usage
python scripts/generate_image.py --model "$GEMINI_MODEL" "A futuristic city skyline at sunset" "./generated-image.png"

# With custom output path
python scripts/generate_image.py "A minimalist app icon for a music player" "./assets/icons/music-icon.png"

# With custom size
python scripts/generate_image.py --size 2K "High resolution landscape" "./wallpaper.png"

要求

  • 必须设置 GEMINI_API_KEY 环境变量
  • Python 3.10+（标准库辅助工具，无需 pip install）
  • 明确审查过的 GEMINI_MODEL 或 --model；验证支持的尺寸/API 架构
  • 已有获准使用的私有输出目录，以及一个新的 .png 文件名

数据、成本和输出检查

提示词会传输给 Google，且可能产生服务提供商费用；请先批准服务/数据范围和成本范围。不要自动安装凭据、重试结果不确定的计费调用或覆盖文件。捆绑的辅助工具会拒绝重定向、限制响应字节数并验证 PNG MIME 类型/签名；它并非完整的图像解码器，也不能证明图像在视觉上正确。套接字超时不能保证总墙钟时间上限。交付后请检查尺寸、内容和权利，并且仅在获得授权时发布。如果宿主要求使用专用图像工具，请使用该工具。

当前 Gemini 图像 API；上游来源说明。

输出

生成的图像将保存为 PNG 文件。脚本会返回：

  • 成功：生成图像的路径
  • 失败：包含详细信息的错误消息

示例

前端开发
User: "I need a hero image for my landing page - something abstract and tech-focused"
-> Generates and saves image, provides path for use in HTML/CSS
文档
User: "Create a diagram showing microservices architecture"
-> Generates visual representation, ready for README or docs
UI 资源
User: "Generate a placeholder avatar image for the user profile component"
-> Creates image in appropriate size for component use

限制

  • 仅当任务明确符合上述范围时，才使用此技能。
  • 不要将输出视为环境特定验证、测试或专家审查的替代品。
  • 如果缺少必需的输入、权限、安全边界或成功标准，请停止并请求澄清。

API 兼容性注意事项

此辅助工具实现的是 generateContent 请求封装；当前链接的图像指南展示的是 Interactions API，其端点、请求字段和响应结构均有所不同。请勿将仅针对 Interactions 宣传的模型用于此辅助工具，也不要假定它支持 imageSize 选项。计费请求前，请明确确认所选模型支持此辅助工具的 generateContent 架构；否则请使用经过审核的服务提供商适配器或宿主图像工具。此处未执行任何 API 调用或平台兼容性测试。命令行提示词参数可能出现在进程列表/历史记录中，因此使用此接口时只能输入非敏感提示词。磁盘写入错误后可能会留下部分输出；请在私有环境中检查，并选择新路径，而不要自动重试服务提供商调用。

评论

支持 Markdown