Skip to content

Repository files navigation

AstrBot Gitee AI Image

让 Bot 有自己的形象, 也有每天不一样的生活.

自拍 · 合影 · 后台生图 · 视频 · 映像工作台

Version AstrBot CI QQ Group

新手图解 · 特色功能 · 推荐服务商 · 出图展示 · 申请与配置教程 · 更新日志

这是一个为 AstrBot 提供 文生图、改图、固定形象自拍、多人合影和视频生成 的插件. 你可以直接用自然语言让 Bot 拍照, 也可以在内置的 映像工作台 WebUI 中配置服务商、批量创作、整理画廊、排版画布和连接节点工作流.

插件开发与交流 QQ 群: 215532038 · 查看群二维码

支持 QQ / aiocqhttp 和个人微信 weixin_oc. 需要 AstrBot >=4.28.0 且 <5.

特色功能

01 · 预设 Bot 形象自拍

本插件的首创设计之一. 预先保存 Bot 的身份参考图, 说一句“拍张你在窗边的照片”, 就能带着固定形象拍摄新照片. 支持多套形象, 用 /换形象 日常 切换当前会话的 Bot 造型.

看实际自拍成片 · 设置自拍与形象库

02 · LLM 后台生图, 不阻塞主对话

本插件的另一项首创设计. LLM 接单后立即回到对话, 单图、自拍、改图和批量任务在后台执行. 等待期间可以继续聊天, Bot 知道任务进度, 完成后再按当前人格回来回应.

开启后台生图

03 · LLM 批量出图, 一次拍一组

让 Bot 自己规划一组不同镜头. 说“给我拍 4 张你在窗边的照片, 同一套衣服, 每张换个姿势和表情”, LLM 会一次调用批量工具, 先规划不同镜头, 再共用身份参考逐张生成.

未指定数量时默认 4 张; 单次上限默认 8 张, 可设置为 1-32. 开启后台生图后, 等照片时可以继续聊天.

按美年达示例配置 · 批量工具参数

让创作连起来的更多能力

特色 可以做什么
04 · Fallback 回退链路 文生图、改图、自拍和视频分别配置主用与备用服务商. 按顺序处理可回退的失败, 不必每次手动切换.
05 · WebUI / 画布 / 画廊 获取模型列表、拖动链路、可视化编辑配置; 在画廊看提示词和大图, 在自由画布排版, 用节点工作流保存创作流程.
06 · 预设提示词 保存常用文生图、改图和视频提示词, 用“预设名 + 本次要求”调用; 改图预设还可注册成独立中文指令.
07 · 他人形象与 Bot 合影 为自己或其他人物建档, 将聊天里的“我”绑定到对应形象. 可以说“我们合照”, 也可以只给“穿西装的我”拍照. 人物身份与穿搭分别约束.
08 · 每天不同的穿搭与场景 联动 日程与穿搭插件 life_scheduler, 让 Bot 默认穿当天的衣服、置身当天的生活场景. 用户明确要求优先.
09 · LLM 拍视频 “你拍个你跳舞的视频我看看”会先按 Bot 形象生成自拍底图, 再转成视频. 普通图片也可以直接做动画, 没有图片时可文生视频.
10 · 变体、仿拍与换装 从一张成片继续规划多组镜头, 编辑每张提示词, 勾选后批量生成; 失败项单独重试, 已成功图片不重跑.
11 · 历史图片与精细控制 联动 ContextAware 引用聊天里的历史图片; 支持比例、精确尺寸、1K/2K/4K、多 Key 轮询、质量参数和无损图片保存.

推荐服务商

以下为作者常用的三个服务商, 免费额度和价格以平台实时页面为准.

Gitee AI · 免费文生图入门

推荐模型: z-image-turbo. 真人写实效果不错, 支持最高 2K. 作者使用的免费额度为 每天 100 张, 适合入门体验文生图.

作者实测内容限制较少, 可生成 NSFW 题材.

只支持文生图, 不能进行参考图自拍、改图或身份合影. 只配置此模型时不要启用参考图自拍. 可以在人设中详细描述人物外貌, 让 LLM 每次带上描述生成“伪自拍”, 但无法锁定同一张脸.

前往 Gitee 模型页 · 查看 Gitee 出图 · API Key 图文申请与配置

美年达 · 真人自拍与二次元创作

作者日常使用并推荐的生图站点, 价格实惠, 出图质量高. 真人写实与 Bot 自拍推荐 Gemini 香蕉系列, 二次元与插画推荐 GPT Image 2 / 2.5 系列.

用途 模型与接入建议
真人写实、Bot 自拍、日常合影 gemini-3.1-flash-image, 使用 Gemini 原生 模板. 下方 10 张 Bot 照片均由作者通过本插件自拍模式生成.
二次元、插画、文生图与改图 GPT Image 全系列, 包括 gpt-image-2、gpt-image-2.5-flare 和 gpt-image-2.5-sunburst, 统一使用 OpenAI Images 模板.

教程提供 美年达香蕉 与 美年达 GPT Image 两套配置示例, 可分别加入自拍、改图和文生图链路.

注册美年达 · 查看 Bot 自拍成片 · 原生配置图解 · 申请 Key 与两套配置示例

注册链接包含作者 AFF 推荐标识.

Agnes AI · 限时免费视频

推荐模型: agnes-video-2.5-flash. 到 platform.agnes-ai.com 注册并创建 API Key, 即可通过本插件调用. 截至 2026-09-16, 官方文档 标明限时免费, 当前价格为 $0/second.

支持文生视频、首尾帧与图片/音频参考, 4 至 12 秒, 720P. 插件按 RPM=1 设置至少 61 秒的请求间隔, 创建和查询共用限速. 同时配置一个支持改图的图片服务商, 就能完成“先自拍, 再转视频”.

注册 Agnes · 申请与视频配置 · 配置 Bot 自拍转视频

限时免费仅覆盖 Agnes 视频, 自拍底图按图片服务商计费.

出图展示

美年达 Gemini 自拍

模型 gemini-3.1-flash-image · 美年达站点 · 本插件自拍模式

作者使用插件自拍模式生成的 10 张 Bot 照片, 点击图片查看大图.

Bot 自拍, 逆光与发丝细节 Bot 自拍, 厨房中的日常穿搭
逆光与细节日常与穿搭
Bot 自拍, 礼帽与墨镜造型 Bot 自拍, 车内通勤场景
造型与表情场景与叙事
展开其余 6 张自拍
Bot 自拍, 手持花束的俯拍视角 Bot 自拍, 面部近景
Bot 自拍, 戴帽阅读的侧面视角 Bot 自拍, 窗边座位上的俯拍构图

Bot 自拍, 卧室日光中的纵向构图

Bot 自拍, 窗边微笑的横向构图

使用同款模型与配置 · 设置自己的 Bot 形象

Gitee Z-Image-Turbo 文生图

模型 z-image-turbo · Gitee AI · 纯文字生成

早期版本的三张真人文生图成片, 未使用身份参考图.

Gitee z-image-turbo 真人文生图示例 1 Gitee z-image-turbo 真人文生图示例 2 Gitee z-image-turbo 真人文生图示例 3

申请免费额度与 API Key · 文字伪自拍说明

申请与配置教程

第一次使用: 在 AstrBot 插件市场搜索 astrbot_plugin_gitee_aiimg, 或按仓库链接安装. 然后按以下顺序设置: 添加服务商 → 保存 Key 与模型 → 加入对应功能链路 → 测试出图. 想让 Bot 保持固定形象, 再设置身份参考与自拍链路.

先看美年达原生配置截图

按需阅读 内容
Gitee 图文申请教程 申请 API Key、查看免费额度, 配置 2K 文生图与文字伪自拍
美年达申请与配置 创建令牌、选择分组, 配置香蕉与 GPT Image 系列
Agnes 免费活动与配置 注册、API Key、模型 ID、完整配置片段及 RPM=1
Bot 自拍转视频 自拍和视频双链路、日程穿搭、开关与工具参数
映像工作台指南 WebUI、服务商、画廊、批量创作、自由画布与节点工作流
后台生图与历史图片 不阻塞对话、任务状态、ContextAware 图片引用与会话隔离
配置与命令参考 中文指令、预设提示词、尺寸、quality、并发、编码、平台限制与常见问题
其他接口配置 OpenAI Images / Chat、Gemini 原生、即梦等模板
更新日志 版本变化与升级说明

配套插件

使用前了解

工作台与节点工作流用于图片创作, 视频通过指令或 LLM 工具调用. 详细能力与限制见 工作台指南.

v5 沿用 v4 配置结构, 从 v3 / v2 升级需重新核对配置. 3365 和 SD2.0 专用模板已移除, 请清理旧服务商及链路引用. 升级前备份插件配置与数据目录, 尤其是形象参考和 studio/ 资产.

交流与反馈

插件开发 QQ 群: 215532038. 欢迎交流配置、分享成片和反馈问题. 报错时附插件版本、所用模型、接口模板与脱敏日志, 不要公开 API Key 或未授权的人物参考图.

插件开发 QQ 群 215532038 二维码

About

接入 Gitee AI 图像生成模型,支持lmm调用(让bot自拍给你看)。

Resources

Stars

78 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages