用途：为网页项目生成有上下文的图片，包括主视觉背景、OG 卡片、占位照片、纹理图案和风格匹配的变体图。
主要能力：按需求确定图片类型、风格、尺寸和数量；用具体摄影参数构建提示词；生成调用 Gemini API 的 Python 脚本（仅用标准库）；支持一次生成多张变体；支持以参考图做风格匹配；可选后处理（缩放、格式转换、优化）。
使用方式：先设置环境变量 export GEMINI_API_KEY="your-key-here"，密钥可从 https://aistudio.google.com/apikey 获取。随后明确需求（类型、风格、尺寸如 hero 1920x1080、OG 1200x630、方形 1024x1024、数量），构建提示词，再生成脚本调用 https://generativelanguage.googleapis.com/v1beta/models/{model}:generateContent，在 generationConfig 中包含 "responseModalities": ["TEXT", "IMAGE"]，解析候选部分中的 inlineData.data（base64），解码保存为 PNG。多张变体保存为 name-1.png、name-2.png。风格匹配时把参考图作为 inlineData 放在文本提示前，temperature 用 0.7。提示词不要用 curl 加 bash 参数传递，应使用 Python 的 json.dumps() 或先写入文件。
预设：hero-background、og-image、placeholder-photo、texture-pattern、product-shot。
模型选择：草稿和快速占位用 gemini-2.5-flash-image（免费，约 500 张/天）；最终客户素材用 gemini-3-pro-image-preview（约 $0.04/张）；风格匹配变体用 gemini-3-pro-image-preview 加参考图（约 $0.04/张）。模型 ID 可能变化，出错时需核实。
限制：需自备 API 密钥；提示词应始终以“No text, no watermarks, no logos, no hands”结尾；具体错误处理与响应解析细节见 references/api-pattern.md，提示词框架见 references/prompting-guide.md。