AstrBot 文生图插件 (Image Generator)

这是一个为 AstrBot 开发的文生图插件，使用火山引擎视觉 API 生成高质量图片。

功能特点

• 🖼️ 高质量图片生成：使用火山引擎视觉 API 生成高质量图片
• 🎨 多种模型支持：支持火山引擎的多种文生图模型
• 🔄 自动清理：自动清理旧图片，避免占用过多存储空间
• 🛠️ 可配置参数：可以配置模型、调度配置等参数
• 💬 自然语言调用：支持通过自然语言对话触发图片生成
• 🔍 智能意图识别：自动识别用户的画图意图

安装方法

1. 将整个 image_generator 文件夹复制到 AstrBot 的 packages 目录下
2. 重启 AstrBot，插件会自动加载

配置方法

在 AstrBot 的 data/config.json 文件中添加以下配置：

"image_generator": {
  "volcengine_model": "high_aes_general_v21_L",
  "schedule_conf": "general_v20_9B_pe",
  "region": "cn-north-1",
  "service": "cv",
  "volcengine_ak": "您的火山引擎访问密钥",
  "volcengine_sk": "您的火山引擎密钥",
  "max_output_images": 10
}

注意：如果不配置 API 密钥，插件将无法生成图片。您需要在火山引擎申请 API 密钥。

安全提示：请勿将您的 API 密钥提交到公开仓库中。建议将密钥存储在本地配置文件中，并将该文件添加到 .gitignore 中。

使用方法

基础命令

• /画图 [提示词] - 生成图片
• /生成图片 [提示词] - 生成图片
• /文生图 [提示词] - 生成图片
• /画 [提示词] - 生成图片
• /draw [提示词] - 生成图片
• /image [提示词] - 生成图片

自然语言调用

您可以通过自然语言对话触发图片生成，例如：

• "帮我画一张猫咪的图片"
• "能不能生成一张风景图"
• "请画一幅山水画"
• "可以帮我画一只狗狗吗"

插件会自动识别您的意图，并生成相应的图片。

示例对话

用户: 画图 一只可爱的猫咪在草地上玩耍
机器人: [生成并显示一只可爱的猫咪在草地上玩耍的图片]

用户: 帮我画一张海边日落的风景图
机器人: [生成并显示海边日落的风景图]

技术实现

• 使用火山引擎视觉 API 生成高质量图片
• 自动清理旧图片，避免占用过多存储空间
• 支持配置模型、调度配置等参数
• 通过关键词匹配实现自然语言意图识别

依赖项

• Python 3.8+
• aiohttp
• requests

文件结构

image_generator/
├── main.py                 # 插件主入口
├── volcengine_api.py       # 火山引擎API封装
├── _conf_schema.json       # 配置模式
├── README.md               # 使用说明
└── output/                 # 输出目录

许可证

MIT

作者

wayzinx

鸣谢

• 感谢 AstrBot 提供的框架支持
• 感谢 火山引擎 提供的视觉 API