强大的 AstrBot 图像生成插件，支持生图、改图、头像参考、表情包切分和 LLM 工具调用。
升级提示：v2.0.0 重构了生图供应商配置，不再复用 AstrBot 本体供应商，也不再读取旧
api_settings。升级后请在供应商配置中重新添加供应商模板。
- 多模式图像生成：纯文本生图、参考图改图、风格转换、手办化、表情包生成。
- 快速预设：头像、海报、壁纸、卡片、手机壁纸、手办化、表情包一键生成。
- 智能参考图：自动读取消息图片、引用图片、合并转发、群文件，以及用户头像和 @ 对象头像。
- 多供应商支持：Google Gemini、Gemini Interactions（Nano Banana 系列）、Vertex AI（服务账号 JSON / Express API Key 双认证）、OpenAI 兼容、OpenAI Images、OpenAI Responses（可自定义顶层模型与生图模型）、Agnes AI、xAI Images、MiniMax、阶跃星辰、豆包、SenseNova、SenseAudio（同步 / 异步图片生成）、DashScope（通义万相/千问图像/z-image）。
- 供应商与模型路由：支持供应商、原始模型或别名选择；未指定时按配置轮询，显式指定时只在匹配候选内重试。
- LLM 工具集成：支持自然语言生图、参数能力查询、后台任务查询和命名批量生成；前台超时后返回任务号并继续生成。
- 插件接入接口：其他 AstrBot 插件可获取公开服务实例、查询就绪状态并提交后台生图任务，支持查询、等待及完成回调；会话与使用者信息可选。详见 其他插件接入指南。
- 表情包切分：内置 SmartMemeSplitter v4，默认优先走自适应黑描边贴纸切分，并保留手动网格、视觉识别等兜底路径。
- 限流与缓存：支持群白名单/黑名单、全插件共享额度与 UMO 会话限流叠加、KV 持久化；Studio 统一管理群限制模式、群号名单与限流规则，可搜索本体已有会话并即时保存。生成图保留在插件数据目录并按容量自动清理，临时文件统一写入 AstrBot 临时目录。
- 内置 WebUI 创作台：Dashboard 插件页「studio」——在线工作台（模型扁平直选、临时生成参数弹窗确认、单图多张与批量生成、参考图上传/画廊拾取）、全来源生成任务实时进度（SSE）、历史画廊（筛选/灯箱/下载/删除/再次生成/用作参考图）；生成历史持久化归档，存量图片自动迁入，运行任务使用的上传参考图受租约保护。详见 使用指南。
- 供应商配置页：配置表、轮询排序、公共设置以二级 Tab 切换；外层直接启停、拖动排序，密钥紧凑展示、逐项管理与批量导入，支持模型拉取选择及本体现有视觉提供商下拉。空闲时统一热保存，不打断生成、不重置 Key 用量。
- AstrBot 4.10+
- Python 3.10+
- NapCat（目前主要适配 NapCat 平台）
- QQ 官方机器人 WebSocket（
qq_official，头像参考已通过真实实例验证）
Warning
代码同时兼容 QQ 官方机器人 Webhook（qq_official_webhook）的头像获取结构，但目前没有真实 Webhook 实例可供验证，因此不在插件元数据中声明支持，也不保证一定可用。
插件市场：搜索 Gemini 图像生成 并安装。
链接安装：在插件界面右下角点击加号，选择从链接安装，输入：
https://github.com/piexian/astrbot_plugin_gemini_image_generation
依赖会按 requirements.txt 自动安装。
插件配置中添加：
- 在
provider_settings.provider_overrides中添加供应商模板（如google/openai_images/agnes_ai），填入api_keys、model、api_base等字段； - 同类型可添加多条模板，通过
priority控制优先级；相同优先级按配置表顺序尝试； - 可选配置
provider_settings.provider_polling，按列表从上到下自动尝试生成；重复供应商会自动去重，未知供应商会记录错误并跳过； - 使用
openai_images、openai_responses、doubao或dashscope且size_mode=custom时，配置界面只显示custom_size，避免混用通用分辨率字段。
接入 SenseAudio 时，添加 senseaudio 模板并填入 api_keys 即可使用默认 Image 2.0 模型；request_mode 可选同步或异步。模型尺寸限制和配置示例见 SenseAudio 配置。
文档索引：
| 命令 | 说明 | 示例 |
|---|---|---|
/生图 |
纯文本生成 | /生图 一只可爱的橙色小猫 |
/改图 |
基于参考图修改 | 发送图片 + /改图 把头发改成红色 |
/换风格 |
风格转换 | 发送图片 + /换风格 水彩 |
/快速 头像 |
头像模式 | /快速 头像 商务风格 |
/快速 海报 |
海报模式 | /快速 海报 赛博朋克 |
/快速 壁纸 |
壁纸模式 | /快速 壁纸 未来城市 |
/快速 卡片 |
卡片模式 | /快速 卡片 商务名片 |
/快速 手机 |
手机壁纸 | /快速 手机 极简风格 |
/快速 手办化 |
手办效果，附图即可；风格和描述可选 | /快速 手办化 + 图片，或 /快速 手办化 2 戴眼镜 + 图片 |
/快速 表情包 |
表情包 | /快速 表情包 Q版可爱 |
/切图 |
切割图片 | /切图 或 /切图 4 4 |
/生图帮助 |
查看帮助 | /生图帮助 |
所有快速模式均自带提示词，额外描述可省略，例如发送图片并输入 /快速 头像、/快速 壁纸 或 /快速 手办化。普通 /生图、/改图 仍需提供描述；/换风格 需指定风格，附加描述可选。
更多参数、快速模式说明和 LLM 工具行为见 使用指南。
各供应商的端点、参数、尺寸适配规则等完整说明见 完整配置参考：
google / gemini_interactions / vertex / openai / agnes_ai / xai / minimax / stepfun / openai_images / openai_responses / doubao / sensenova / senseaudio / dashscope / modelscope / siliconflow
astrbot_plugin_gemini_image_generation/
├── main.py # 插件主入口
├── _conf_schema.json # 配置 Schema
├── docs/ # 配置、使用、故障排除和适配器文档
├── pages/ # Dashboard 插件页（studio 创作台，纯静态）
├── templates/ # 帮助页面模板
└── tl/ # 核心模块和供应商适配器
tl/ 目录接口索引见：tl 模块接口说明。
欢迎提交 Issue 和 Pull Request。
开发环境、验证与提交约定见 开发指南；新增 API 供应商见 适配器开发指南。
- @MliKiowa - 图像切割算法
- @exynos967 - 限流设置、手办化功能、OpenAI 兼容、Zai 供应商、快速模式配置
- @zouyonghe - 代理支持、保留参考图尺寸、空格参数支持
- @vmoranv - 表情包提示词优化、自适应黑描边贴纸切分、线条切图修复
- @itismygo - grok2api 适配
- @xunxiing - OpenAI Images 端点支持、配置提示修复
- @Clhikari - 快速生图修复
- @YukiRa1n - GIF 支持、多项修复
AGPL-3.0 License - 详见 LICENSE。