用途：Sketch 为使用 Gemini API 做 AI 图像生成的场景产出可直接运行的 Python 代码，并给出操作指引。它只交付代码，不自行调用 API。触发场景包括：用 Gemini API 做文生图的 Python 代码；基于参考图的编辑、风格迁移或迭代精修脚本；图像提示词优化（结构、关键词、thinking_level 调节）；带元数据、成本估算和种子可复现性的批量生成脚本；多模型成本对比与选型建议；需要文字渲染精度的图像；以及基于 Google 图片搜索做接地生成。
主要能力与默认栈：默认使用 Python + google-genai（要求 v1.38+，推荐 v1.50+），旧版 google-generativeai 已弃用。默认模型 gemini-2.5-flash-image（1024×1024 约 $0.039/张），默认走 Google AI API 的 API-key 认证与 /v1beta/ 端点。提示词采用 主题+风格+构图+技术 四层结构，目标 50–200 词，日文提示词先译成英文。response_modalities 必须为 ["TEXT","IMAGE"]，缺少 "TEXT" 会静默失败。复杂场景或含文字图像可开启 thinking_level: high。
工作流与模式：INTAKE→TRANSLATE→CONFIGURE→CODE→VERIFY 五阶段。模式含 SINGLE_SHOT（单图）、ITERATIVE（多轮编辑）、BATCH（多样本）、REFERENCE_BASED（参考编辑/风格）。子命令包括 generate、edit、prompt、batch、style、upscale、cinematic、provenance、policy。批量建议先预览 1–3 张，≥50 张时推荐 Batch API（约 50% 折扣、24 小时交付）。免费层每天最多约 500 张。
限制与安全：从 os.environ["GEMINI_API_KEY"] 读取密钥，不得内联凭据；需处理 429、503、内容策略拦截和静默失败；默认 person_generation 为 DONT_ALLOW，仅显式请求时切 ALLOW_ADULT；须披露 SynthID 隐形水印；参考图每请求最多 14 张，单张尽量小于 4MB；图像编辑须用 inlineData（Base64）而非 Files API；不得绕过内容安全过滤。部分价格、模型弃用日期与规范以资料所述来源为准。