nonebot-plugin-jimeng 0.1.7

一个基于 NoneBot2 的 AI 绘画插件，通过调用**即梦（Jimeng）**的 OpenAPI 实现文生图和图生图功能。

✨ 即梦绘画 ✨

📖 介绍

一个基于 NoneBot2 的 AI 绘画插件，通过调用**即梦（Jimeng）**的 OpenAPI 实现文生图和图生图功能。

• 文生图：根据文本描述生成图片。
• 图生图：结合图片和文本描述生成新的图片。
• 多账号支持：内置简单的多账号轮询和积分管理机制。

💿 安装

使用 nb-cli 安装 (推荐)

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

nb plugin install nonebot-plugin-jimeng --upgrade

使用包管理器安装

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

pip

pip install nonebot-plugin-jimeng

pdm

pdm add nonebot-plugin-jimeng

poetry

poetry add nonebot-plugin-jimeng

uv

uv pip install nonebot-plugin-jimeng

安装后，请打开 nonebot2 项目根目录下的 pyproject.toml 文件, 在 [tool.nonebot] 部分的 plugins 列表中添加 nonebot_plugin_jimeng 以加载插件。

[tool.nonebot]
plugins = [
    # ... other plugins
    "nonebot_plugin_jimeng"
]

⚙️ 配置

在您的 nonebot2 项目的 .env 或 .env.prod 文件中添加以下配置项。

配置项	必填	默认值	说明
JIMENG__ACCOUNTS	否	[]	即梦账号（目前主要是国际服支持账密登录）列表。当 JIMENG_USE_ACCOUNT=true 时需要填写。格式为 '[{"account": "[e-mail]", "password": "password1"}, ...]'
JIMENG__USE_ACCOUNT	否	True	是否通过账号自动获取密钥。如果设为 False，则需要提供 JIMENG_SECRET_KEY。
JIMENG__OPEN_API_URL	否	''	逆向 API 的地址或官方API地址。
JIMENG__MODEL	否	jimeng-4.5	默认使用的绘画模型。
JIMENG__RESOLUTION	否	2k	图片分辨率。
JIMENG__MAX_CONCURRENT_TASKS_PER_USER	否	2	每个用户的最大并发任务数。
JIMENG__MAX_RETRIES	否	3	请求失败时的最大重试次数，一般是上传图片出现问题重试。
JIMENG__RETRY_DELAY	否	1	每次重试的间隔时间（秒）。
JIMENG__TIMEOUT	否	1	发送API请求的超时时间（秒）。
JIMENG__SECRET_KEY	否	""	API 密钥。当 JIMENG_USE_ACCOUNT=false 时生效。

JIMENG_ACCOUNTS 格式说明

这是一个 JSON 字符串数组，每个对象代表一个即梦账号。插件启动时会根据此配置初始化 session_id。

配置示例： JIMENG__ACCOUNTS配置示例

# .env.prod
JIMENG_ACCOUNTS='[{"email": "[e-mail]", "password": "12234" , "region": "hk"}, {"email": "[e-mail]", "password": "12234" , "region": "jp"}]'

💡 注意事项

如果使用图生图功能，请确保你的图片可以被正确访问

🎉 使用

指令表

指令	说明
/即梦绘画 <关键词>	文生图。根据提供的关键词进行创作。
/即梦绘画 <关键词> (回复图片)	图生图。回复一张图片，并附上关键词，将在原图基础上进行创作。

🎨 效果图

文生图

/即梦绘画 画一个二次元狐娘给我

图生图 (回复一张图片)

/即梦绘画 让她躺在一个洁白的床

🙏 致谢

感谢 https://github.com/iptag/jimeng-api 提供的 OpenAPI 支持。