Skip to content
Projekte

piexian/astrbot_plugin_gemini_image_generation

Auf GitHub ansehen

piexian/astrbot_plugin_gemini_image_generation has 55 GitHub stars and 15 forks. GitHot measured 0 stars in 24 hours, 0 in 7 days, and 0 in 15 days. Last checked 2026-11-20 06:26 UTC. Last push 2026-11-08.

So werden diese Zahlen gemessen

Gemessener Sternzuwachs

in 24h
0
in 7 days
0
in 15 days
0
in 1 month
Verlauf wird gesammelt

Nettoänderungen in überlappenden Zeiträumen, keine Tagessummen. Fehlende Messwerte bleiben leer. Sterne zeigen Interesse, nicht Qualität.

Über uns

图像生成插件,支持生图和改图,可以自动获取头像作为参考等。

Kreativität und Medien

README.md

Original

AstrBot Gemini 图像生成插件

强大的 AstrBot 图像生成插件,支持生图、改图、头像参考、表情包切分和 LLM 工具调用。

升级提示:v2.0.0 重构了生图供应商配置,不再复用 AstrBot 本体供应商,也不再读取旧 api_settings。升级后请在 供应商配置 中重新添加供应商模板。

功能概览

  • 多模式图像生成:纯文本生图、参考图改图、风格转换、手办化、表情包生成。
  • 快速预设:头像、海报、壁纸、卡片、手机壁纸、手办化、表情包一键生成。
  • 智能参考图:自动读取消息图片、引用图片、合并转发、群文件,以及用户头像和 @ 对象头像。
  • 生成记录引用:生成结果带 gen: 引用号,可以直接要求 AI 拿某张已生成的图继续改图;默认只允许引用本会话的记录,跨会话引用需打开「允许跨会话引用生成图」。
  • 多供应商支持: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 工具集成:gemini_image_generation 单图生图改图、gemini_image_batch 批量提交、gemini_image_lookup 查询模型/模板/可引用的生成记录/后台任务、gemini_image_share 由本人共享或取消共享生成记录;任务完成后自动通知,前台等待超时直接返回图片地址继续发送。详见 LLM 工具集成。
  • 插件接入接口:其他 AstrBot 插件可获取公开服务实例、查询就绪状态并提交后台生图任务,支持查询、等待及完成回调;会话与使用者信息可选。详见 其他插件接入指南。
  • 表情包切分:内置 SmartMemeSplitter v4,默认优先走自适应黑描边贴纸切分,并保留手动网格、视觉识别等兜底路径。
  • 限流与缓存:支持群白名单/黑名单、全插件共享额度与 UMO 会话限流叠加、KV 持久化;Studio 统一管理群限制模式、群号名单与限流规则,可搜索本体已有会话并即时保存。生成图保留在插件数据目录并按容量自动清理,临时文件统一写入 AstrBot 临时目录。
  • 内置 WebUI 创作台:Dashboard 插件视图「studio」(需 AstrBot ≥4.29,界面语言跟随 Dashboard)——在线工作台(模型扁平直选、临时生成参数弹窗确认、单图多张与批量生成、参考图上传/画廊拾取)、全来源生成任务实时进度(SSE)、历史画廊(筛选/灯箱/下载/删除/再次生成/用作参考图);生成历史持久化归档,存量图片自动迁入,运行任务使用的上传参考图受租约保护。详见 使用指南。
  • 提示词模板库:快速模式的提示词全部改为可编辑模板,支持内置模板、自建模板和 JSON 包导入导出;每个模板可单独开关「对 AI 可用」并设置默认分辨率与比例,生成历史会记录用了哪个模板。详见 提示词模板库。
  • 提示词广场与在线模板:Studio「提示词广场」页签按名称、说明或标签搜索模板,支持新建/编辑/复制/删除、恢复内置默认和填入工作台;在线模板库可检索查看别人分享的模板、导入为本地副本、立即同步、上传自己的模板与举报,密钥支持申请、校验、回填和吊销,联网方式由配置项「在线模板使用方式」选择仅本地缓存、实时检索或完全不联网。详见 提示词广场。
  • 供应商配置页:配置表、轮询排序、公共设置以二级 Tab 切换;外层直接启停、拖动排序,密钥紧凑展示、逐项管理与批量导入,支持模型拉取选择及本体现有视觉提供商下拉。空闲时统一热保存,不打断生成、不重置 Key 用量。

快速安装

前置要求

  • AstrBot 4.10+
  • Python 3.12+
  • 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/                   # 配置、使用、故障排除和适配器文档
├── views/                  # Dashboard 插件视图(studio 创作台,纯静态,需 AstrBot ≥4.29)
├── .astrbot-plugin/i18n/   # 视图标题与界面文案翻译(跟随 Dashboard 语言)
├── 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。

相关链接

Star History