gemini-image-simple

name	gemini-image-simple
version	1.2.0
description	生成或编辑图片（Gemini API）。当用户要求生成图片、画图、编辑图片、图像处理时使用。零依赖纯 Python 实现，无需 pip/uv。
metadata	{"openclaw":{"emoji":"🎨","requires":{"env":["ZXM_GEMINI_API_KEY","ZXM_GEMINI_API_BASE_URL"]}}}

Gemini Image Simple

使用纯 Python 标准库通过 Gemini API 生成和编辑图片。默认使用 gemini-3.1-flash-image-preview-2k，也支持通过 --model 参数切换到其他模型（如 gemini-3-pro-image-preview）。

为什么用这个 Skill

特性	这个 Skill	其他方案（nano-banana-pro 等）
依赖	无（仅 stdlib）	google-genai、pillow 等
需要 pip/uv	❌ 不需要	✅ 需要
能在 Fly.io free 跑	✅ 可以	❌ 会失败
能在容器里跑	✅ 可以	❌ 经常失败
图片生成	✅ 完整支持	✅ 完整支持
图片编辑	✅ 支持	✅ 支持
配置复杂度	只要设置 API key	先安装依赖包

一句话总结： 只要有 Python 3，这个 skill 基本就能跑。不需要包管理器、不需要虚拟环境，也少碰权限问题。

快速开始

# 生成
python {baseDir}/scripts/generate.py "A cat wearing a tiny hat" cat.png

# 编辑现有图片
python {baseDir}/scripts/generate.py "Make it sunset lighting" edited.png --input original.png

用法

生成新图片

python {baseDir}/scripts/generate.py "your prompt" output.png

编辑现有图片

python {baseDir}/scripts/generate.py "edit instructions" output.png --input source.png

指定模型

python {baseDir}/scripts/generate.py "your prompt" output.png --model gemini-3-pro-image-preview

支持的输入格式：PNG、JPG、JPEG、GIF、WEBP

环境变量

设置以下环境变量：

• ZXM_GEMINI_API_KEY：Gemini API Key，可在 https://aistudio.google.com/apikey 获取。
• ZXM_GEMINI_API_BASE_URL：Gemini API 基础地址，默认值为 https://generativelanguage.googleapis.com。

工作原理

使用 Gemini 3.1 Flash Image（gemini-3.1-flash-image-preview-2k）作为默认模型：

• 用纯 urllib.request 发 HTTP 请求（不依赖 requests）
• 用纯 json 做解析（stdlib）
• 用纯 base64 做编码（stdlib）

就这些。没有外部依赖，任何 Python 3.10+ 环境都能跑。

模型

当前默认：gemini-3.1-flash-image-preview-2k

其他可用模型（如有需要，可在 generate.py 中修改）：

• gemini-3-pro-preview - Gemini 3 Pro（通用）
• gemini-3.1-flash-image-preview-0.5k - Flash Image，0.5k 输出
• gemini-3.1-flash-image-preview-2k - Flash Image，2k 输出
• gemini-3.1-flash-image-preview-4k - Flash Image，4k 输出

示例

# 风景
python {baseDir}/scripts/generate.py "Misty mountains at sunrise, photorealistic" mountains.png

# 产品图
python {baseDir}/scripts/generate.py "Minimalist product photo of a coffee cup, white background" coffee.png

# 编辑：切换风格
python {baseDir}/scripts/generate.py "Convert to watercolor painting style" watercolor.png --input photo.jpg

# 编辑：添加元素
python {baseDir}/scripts/generate.py "Add a rainbow in the sky" rainbow.png --input landscape.png

提示词参考

references/ 目录下有 4 份参考文档：

文件	内容
prompt-examples.md	精选风格模板（水彩、刺绣、等边、文字特效等）
prompt-catalog.md	968 条社区案例按 18 个分类整理（插画、品牌、Logo、肖像等）
prompt-modifiers.md	风格/光线/构图/材质修饰词速查表 + 5 个常用后缀模板
ppt-style-images.md	类 PPT / 信息图生成专项指南，含 20 种风格和幻灯片模板

推荐用法：

• 日常生图 → prompt-modifiers.md 挑修饰词
• 找灵感 → prompt-catalog.md 按分类浏览
• 做汇报 / 信息图 → ppt-style-images.md