koishi-plugin-free-moda

使用 ModelScope（魔搭）免费 API 进行图片生成和编辑的 Koishi 插件。

功能特性

• 🎨 图片编辑：基于 Qwen-Image-Edit 模型，支持对图片进行语义和外观编辑
• 🖼️ 图片生成：基于 Qwen-Image 模型，根据文字描述生成图片
• 🚀 零外部依赖：仅使用 Koishi 内置的 HTTP 服务
• 🔄 自动图床上传：自动处理本地图片上传
• 🔧 自定义模型：支持配置任意 ModelScope 上的图片生成模型
• 📊 多 Key 轮询：支持配置多个 API Key 自动轮询使用

配置项

基础配置

• apiKeys：ModelScope API Token 列表（必填）
  • 支持配置多个 API Key，插件会自动轮询使用
  • 获取方式：访问 ModelScope 注册账号后在个人中心获取
  • 格式：ms-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

模型配置

• editModel：图片编辑模型（默认：Qwen/Qwen-Image-Edit）

  • 支持 ModelScope 上的图片编辑模型
  • 可通过 moda.models 命令查看可用模型

• generateModel：图片生成模型（默认：Qwen/Qwen-Image）

  • 支持 ModelScope 上的文生图模型
  • 可通过 moda.models 命令查看可用模型

使用方法

查看可用模型

moda.models
# 或使用别名
模型列表

这会列出 ModelScope 上所有可用的图片生成模型，你可以在配置中选择使用。

图片编辑

# 方式1：先发送图片，再使用命令
[发送图片]
moda.edit 把头发变成蓝色

# 方式2：引用包含图片的消息
[引用消息] moda.edit 把猫的颜色变成紫色

# 使用别名
图片编辑 添加一个红色的帽子

图片生成

moda.generate 一只可爱的紫色猫咪

# 使用别名
生成图片 夕阳下的城市天际线

支持的编辑类型

• 语义编辑：IP 创作、物体旋转、风格转换等
• 外观编辑：添加/删除元素、修改颜色、更换背景/服装等
• 文字编辑：支持中英文文字的添加、删除和修改

注意事项

• 图片生成需要一定时间（通常 10-30 秒），请耐心等待
• 免费 API 有调用频率限制，请合理使用
• 图片编辑功能需要提供可公网访问的图片 URL
• 本地图片会自动上传到 ImgBB 图床

示例

图片编辑示例：

• "把图片中 q 版人物头发颜色变成蓝发"
• "将背景改成星空"
• "给猫咪添加一副眼镜"
• "把文字'Hello'改成'你好'"

图片生成示例：

• "一只在草地上玩耍的可爱猫咪"
• "赛博朋克风格的城市夜景"
• "水墨画风格的山水画"

License

MIT