nonebot-plugin-easy-aidraw 0.1.0

AI绘图插件 for NoneBot2，支持多种绘图API

nonebot_plugin_aidraw 0.1.0

✨Nonebot & AI 绘图 插件 ✨

仓库   ·   指令 & 反馈   ·   常见问题

快速使用

安装

以下提到的方法 任选其一 即可

[推荐] 使用 nb-cli 安装

在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装

nb plugin install nonebot-plugin-aidraw

使用包管理器安装

在 nonebot2 项目的插件目录下, 打开命令行, 根据你使用的包管理器, 输入相应的安装命令

pip

pip install nonebot-plugin-aidraw

pdm

pdm add nonebot-plugin-aidraw

poetry

poetry add nonebot-plugin-aidraw

conda

conda install nonebot-plugin-aidraw

uv

uv install nonebot-plugin-aidraw

env最简化配置

draw_api_url = "http://localhost:8080" # API 地址 draw_api_key = "" # API 密钥 draw_model = "gpt-image-2" # 模型名称

功能

• 绘图 调用绘图 API 生成图片

支持的绘图后端

• 任意 OpenAI 兼容的 /v1/images/generations 接口（如 OpenAI、Gemini、本地自部署等）
• 返回 url 时直接转发图片链接
• 自定义 API 地址、密钥、模型、尺寸、超时

NSFW 过滤

• 群聊场景下可选启用 NSFW 关键词过滤（DRAW_NSFW_ENABLED=true + DRAW_NSFW_KEYWORDS=[...]）
• 私聊自动跳过检测

输出容错

• 一旦拿到图片 URL，即使后续发送环节出现小问题，也不会再向用户推送错误消息，避免误扰

主要功能

• 调用 OpenAI 兼容绘图接口生成图片
• 支持自定义 API 地址、密钥、模型
• 支持 base64 / URL 两种返回格式
• 群聊 NSFW 关键词过滤（可关闭）
• 黑白名单访问控制（支持群组/用户 ID）

env 设置

draw_api_url = "http://localhost:8080"      # API 地址
draw_api_key = ""                           # API 密钥
draw_model = "flux"                         # 模型名称
draw_backend = "openai"                     # 后端类型: openai/gemini/sd
draw_default_size = "1024x1024"            # 图片尺寸
draw_timeout = 120                          # 超时时间(秒)
draw_nsfw_enabled = false                  # NSFW 检测（仅群聊）
draw_nsfw_keywords = []                    # NSFW 关键词
draw_whitelist_mode = false                # 白名单模式
draw_whitelist = []                        # 白名单
draw_blacklist = []                         # 黑名单

draw_api_url 留空时使用后端默认地址；填写时作为后缀拼接到 base URL 后面 ID 格式：group_123456（群组）或 123456（私聊）

其他

• 如果您有发现 BUG 或者更好的建议，欢迎提 Issue & Pr
• 如果本插件对你有帮助，不要忘了点个 Star~
• 本项目仅供学习使用，请勿用于商业用途
• MIT License ©@Agnes4m

🌐 感谢

• nonebot2 - 聊天机器人的基础框架
• nonebot-plugin-alconna - NoneBot2 的 Alconna 适配