支持gemini官方api
征求api请求格式 请提ls 看到了可以考虑融合在一起
docker部署输出lm列表的时候全是符号 解决办法 请运行
apt update
apt install -y fonts-dejavu fonts-noto fonts-freefont-ttf
手动部署请什root权限运行(针对linux)
通过第三方柏拉图api调用 Banana的api使用
注册地址 柏拉图1
原先bnn涨价原因
因为nano-banana涨价到0.08一次毫无性价比,上了自定义模型建议全部换成gemini-2.5-flash-image-preview、gemini-2.5-flash-image。
测试下来效果是一样的
功能特性
- 多风格转换:内置十几种指令,如
#手办化、#Q版化、#痛车化、#鬼图等,满足不同场景需求。 - 自定义生成:使用
#bnn <提示词>指令,可以完全自定义 Prompt 进行创作。 - 灵活的输入方式:支持直接发送图片、回复图片、或
@用户来使用其头像进行制作。 - 强大的管理功能 (管理员限定):
- Key 管理:通过指令动态添加、查看、删除 API Key,支持配置多个 Key 并自动轮换使用。
- 用户次数管理:可为普通用户设置使用次数,并通过指令进行增加和查询,实现轻量级付费或激励机制。
- 高度可定制:所有指令的默认提示词(Prompt)都在后台配置文件中开放,可随时按自己的喜好进行微调。
- 代理支持:内置网络代理支持,方便在特殊网络环境下部署。
安装与配置
安装
- 将该文件夹放入
astrbot/plugins目录下。 - 重启 AstrBot。
配置
在 AstrBot 管理面板的 插件管理 -> 手办工坊 Pro 中进行配置。常用项说明:
| 配置项 | 说明 |
|---|---|
generic_api_url |
Generic 模式 API 地址,例如 https://api.example.com/v1/chat/completions |
generic_api_keys |
Generic 模式 Key 池(可多条轮询),示例:123 |
gemini_api_url |
Gemini 官方 Base 地址,默认 https://generativelanguage.googleapis.com |
gemini_api_keys |
Gemini 官方模式 Key 池 |
api_mode |
协议模式:generic / gemini_official |
model_list |
可用模型 ID 列表,默认包含 nano-banana 等 |
model |
默认模型(需在模型列表中存在),示例:gemini-2.5-flash-preview-image |
image_resolution |
画质/分辨率参数,例:4K |
enable_power_model |
开启强力模式开关 |
power_model_keyword |
强力模式触发词,格式:指令 + 空格 + 触发词 + 提示词,例:手办化 pro [图] |
power_model_id |
强力模型 ID,例:gemini-3-pro-preview-image |
power_model_tip_enabled |
是否在普通模式回复里提醒强力模式格式和扣费 |
power_model_extra_cost |
强力模式额外扣次数(基础 1 次+额外值) |
show_model_info |
是否在成功/失败消息中显示实际调用模型 |
debug_mode |
调试模式,开启后报错会附加完整错误内容 |
prefix |
是否需要命令前缀或 @ 才触发 |
extra_prefix |
自定义提示词前缀(如 bnn,用 bnn |
use_proxy / proxy_url |
启用代理与代理地址 |
timeout |
请求超时(秒),默认 120 |
use_stream |
Generic 模式是否走流式请求 |
download_retries |
图片下载重试次数 |
help_text |
自定义 #手办化帮助 文本 |
user_whitelist / user_blacklist |
用户白/黑名单 |
group_whitelist / group_blacklist |
群聊白/黑名单,白名单群不限制次数 |
enable_user_limit / enable_group_limit |
是否启用用户/群组次数限制 |
enable_checkin |
是否启用每日签到获取次数 |
checkin_fixed_reward |
签到固定奖励(未开启随机时) |
enable_random_checkin / checkin_random_reward_max |
签到随机奖励开关与最大值 |
prompt_list |
预设提示词列表,格式:触发词:提示词,可用 #lm添加 管理 |
使用方法
- 发送图片并使用命令。
- 引用含有图片的消息并使用命令。
- @某人并使用命令 (将使用该用户的头像)。
新增
新增签到系统,文生图功能和自定义模型
📖 命令列表
基础与新增命令(合并)
| 命令 | 功能说明 |
|---|---|
#文生图 <描述> |
文生图:输入描述生成图片 |
#自定义 <提示词> |
搭配图片使用自定义提示词进行图生图(回复/携带图片) |
#手办化 |
生成角色的手办造型,偏向立体模型展示 |
#手办化2 |
生成另一种风格的手办造型,可能是细节或比例的不同 |
#手办化3 |
生成不同版本的手办展示,更偏系列感 |
#手办化4 |
生成手办化第四种风格,可能是更精致或特殊造型 |
#手办化5 |
生成另一种改良版手办造型 |
#手办化6 |
生成手办化的第六种衍生风格 |
#Q版化 |
生成Q版(可爱简化比例)的角色形象 |
#痛屋化 |
生成痛屋(贴满角色元素装饰的房间)场景 |
#痛屋化2 |
生成改良版痛屋场景,更丰富或现代感 |
#痛车化 |
生成痛车(贴有角色图案的车辆)造型 |
#cos化 |
生成角色cosplay化的照片风格 |
#cos自拍 |
生成角色自拍风格的cos照片 |
#孤独的我 |
生成孤独、滑稽或小丑化的意境图 |
#第三视角 |
生成第三人称视角场景,看起来像他人在看角色 |
#鬼图 |
生成灵异鬼图风格照片,带恐怖氛围 |
#第一视角 |
生成第一人称视角场景,沉浸感强 |
#贴纸化 |
生成贴纸风格的小图,方便做表情或周边 |
#玉足 |
生成角色玉足相关的画面或细节 |
#fumo化 |
生成毛绒玩偶(fumo)风格角色 |
#cos相遇 |
生成两位cos角色相遇的场景 |
#三视图 |
生成角色三视图(正面、侧面、背面) |
#穿搭拆解 |
生成角色服装穿搭的详细拆解图 |
#拆解图 |
生成模型拆解或零件展示图 |
#角色界面 |
生成类似游戏中角色信息界面的画面 |
#角色设定 |
生成角色设定图,包含全身、武器、细节等 |
#3D打印 |
生成适合3D打印的模型预览图 |
#微型化 |
生成微缩模型、小比例角色形象 |
#挂件化 |
生成挂件、钥匙扣风格的角色造型 |
#姿势表 |
生成角色姿势参考表,多种动作合集 |
#高清修复 |
对画面进行高清化、细节修复 |
#人物转身 |
生成人物转身动作的连续画面 |
#绘画四宫格 |
生成四宫格绘画对比图或进度展示 |
#发型九宫格 |
生成九种不同发型的对比图 |
#头像九宫格 |
生成九个不同风格的头像合集 |
#表情九宫格 |
生成角色九种不同表情合集 |
#多机位 |
生成多机位拍摄的场景视角合集 |
#电影分镜 |
生成电影风格的分镜图 |
#动漫分镜 |
生成动漫风格的分镜图 |
#真人化 |
生成角色的真人化形象(真实感较强) |
#真人化2 |
生成另一种风格的真人化形象 |
#半真人 |
生成半写实半动漫的混合风格 |
#半融合 |
生成角色与其他元素融合的半融合风格 |
自定义与查询
| 命令 | 功能说明 |
|---|---|
#bnn <提示词> |
使用自定义提示词生成 |
#手办化查询次数 |
查询自己的剩余次数 |
👑 管理命令 (仅主人)
| 命令 | 功能说明 |
|---|---|
#手办化添加key <key1>... |
添加一个或多个API密钥 |
#手办化key列表 |
查看API密钥列表 |
#手办化删除key <序号|all> |
删除API密钥 |
#手办化增加次数 <QQ号> <次数> |
为用户增加使用次数 |
#手办化查询次数 <QQ号> |
查询指定用户剩余次数 |
🎨 效果展示
以下图片均为插件实际生成效果。
#手办化 |
#cos化 |
|---|---|
![]() |
![]() |
| #第一视角 | #第三视角 |
![]() |
![]() |
注
本插件是基于维拉大佬写的js改的。 感谢维拉大佬的支持



