强大的 AstrBot 图像生成插件，支持生图、改图、头像参考、表情包切分和 LLM 工具调用。
升级提示：v2.0.0 重构了生图供应商配置，不再复用 AstrBot 本体供应商，也不再读取旧
api_settings。升级后请在供应商配置中重新添加供应商模板。
- 多模式图像生成：纯文本生图、参考图改图、风格转换、手办化、表情包生成。
- 快速预设：头像、海报、壁纸、卡片、手机壁纸、手办化、表情包一键生成。
- 智能参考图：自动读取消息图片、引用图片、合并转发、群文件，以及用户头像和 @ 对象头像。
- 多供应商支持：Google Gemini、OpenAI 兼容、OpenAI Images、Agnes AI、xAI Images、MiniMax、阶跃星辰、Zai、grok2api、豆包、SenseNova、DashScope（通义万相/千问图像）。
- 供应商与模型路由：支持供应商、原始模型或别名选择；未指定时按配置轮询，显式指定时只在匹配候选内重试。
- LLM 工具集成：支持自然语言生图、参数能力查询、后台任务查询和命名批量生成；前台超时后返回任务号并继续生成。
- 表情包切分：内置 SmartMemeSplitter v4，默认优先走自适应黑描边贴纸切分，并保留手动网格、视觉识别等兜底路径。
- 限流与缓存：支持群白名单/黑名单、周期限流、KV 持久化、临时文件自动清理。
- 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、doubao或dashscope且size_mode=custom时，配置界面只显示custom_size，避免混用通用分辨率字段。
常用配置入口：
| 命令 | 说明 | 示例 |
|---|---|---|
/生图 |
纯文本生成 | /生图 一只可爱的橙色小猫 |
/改图 |
基于参考图修改 | 发送图片 + /改图 把头发改成红色 |
/换风格 |
风格转换 | 发送图片 + /换风格 水彩 |
/快速 头像 |
头像模式 | /快速 头像 商务风格 |
/快速 海报 |
海报模式 | /快速 海报 赛博朋克 |
/快速 壁纸 |
壁纸模式 | /快速 壁纸 未来城市 |
/快速 卡片 |
卡片模式 | /快速 卡片 商务名片 |
/快速 手机 |
手机壁纸 | /快速 手机 极简风格 |
/快速 手办化 |
手办效果 | /快速 手办化 [1/2] 动漫角色 |
/快速 表情包 |
表情包 | /快速 表情包 Q版可爱 |
/切图 |
切割图片 | /切图 或 /切图 4 4 |
/生图帮助 |
查看帮助 | /生图帮助 |
更多参数、快速模式说明和 LLM 工具行为见 使用指南。
各供应商的端点、参数、尺寸适配规则等完整说明见 完整配置参考：
google / openai / zai / grok2api / agnes_ai / xai / minimax / stepfun / openai_images / doubao / sensenova / dashscope
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。