强大的 AstrBot 图像生成插件，支持生图、改图、头像参考、表情包切分和 LLM 工具调用。
升级提示：v1.9.0 以后的配置文件格式不兼容 v1.8.x 及更早版本。升级后如遇配置模板显示错误，请查看 配置迁移说明。
- 多模式图像生成：纯文本生图、参考图改图、风格转换、手办化、表情包生成。
- 快速预设：头像、海报、壁纸、卡片、手机壁纸、手办化、表情包一键生成。
- 智能参考图：自动读取消息图片、引用图片、合并转发、群文件，以及用户头像和 @ 对象头像。
- 多供应商支持：Google Gemini、OpenAI 兼容、OpenAI Images、xAI Images、MiniMax、阶跃星辰、Zai、grok2api、豆包。
- LLM 工具集成：支持自然语言触发生图，前台短等待，超时后自动转后台发送。
- 表情包切分：内置 SmartMemeSplitter v4，并提供手动网格、视觉识别、主体吸附等兜底路径。
- 限流与缓存：支持群白名单/黑名单、周期限流、KV 持久化、临时文件自动清理。
- AstrBot 4.10+
- Python 3.10+
- NapCat（目前主要适配 NapCat 平台）
插件市场：搜索 Gemini 图像生成 并安装。
链接安装：在插件界面右下角点击加号，选择从链接安装，输入：
https://github.com/piexian/astrbot_plugin_gemini_image_generation
依赖会按 requirements.txt 自动安装。
至少需要配置一个可用的图像模型供应商。以下两种方式 二选一：
- 方式 A：复用 AstrBot 提供商
- 在
api_settings.provider_id中选择已在 AstrBot 中配置好的提供商，并把api_settings.api_type设为对应类型（google/openai等）。
- 在
- 方式 B：使用插件内置覆盖配置
- 在
api_settings.api_type中选择目标类型； - 在
api_settings.provider_overrides中添加同名模板（如google），填入api_keys、model、api_base等字段；
- 在
常用配置入口：
| 命令 | 说明 | 示例 |
|---|---|---|
/生图 |
纯文本生成 | /生图 一只可爱的橙色小猫 |
/改图 |
基于参考图修改 | 发送图片 + /改图 把头发改成红色 |
/换风格 |
风格转换 | 发送图片 + /换风格 水彩 |
/快速 头像 |
头像模式 | /快速 头像 商务风格 |
/快速 海报 |
海报模式 | /快速 海报 赛博朋克 |
/快速 壁纸 |
壁纸模式 | /快速 壁纸 未来城市 |
/快速 卡片 |
卡片模式 | /快速 卡片 商务名片 |
/快速 手机 |
手机壁纸 | /快速 手机 极简风格 |
/快速 手办化 |
手办效果 | /快速 手办化 [1/2] 动漫角色 |
/快速 表情包 |
表情包 | /快速 表情包 Q版可爱 |
/切图 |
切割图片 | /切图 或 /切图 4 4 |
/生图帮助 |
查看帮助 | /生图帮助 |
更多参数、快速模式说明和 LLM 工具行为见 使用指南。
各供应商的端点、参数、尺寸适配规则等完整说明见 完整配置参考：
astrbot_plugin_gemini_image_generation/
├── main.py # 插件主入口
├── _conf_schema.json # 配置 Schema
├── docs/ # 配置、使用、故障排除和适配器文档
├── 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。