Package Exports
- koishi-plugin-free-moda
- koishi-plugin-free-moda/lib/index.js
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (koishi-plugin-free-moda) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
koishi-plugin-free-moda
使用 ModelScope（魔搭）免费 API 进行图片生成和编辑的 Koishi 插件。
功能特性
- 🎨 多模型支持：内置多个文生图和图片编辑模型，支持自定义扩展
- 🖼️ 文生图：通用模型、美人模型、特化模型等多种选择
- ✏️ 图片编辑：支持语义编辑、外观修改、文字处理等
- 📐 智能分辨率：自动识别原图分辨率，支持自定义输出尺寸
- 🚀 表格配置：直观的模型管理界面，支持自定义别名和描述
- 🔄 多 Key 轮询：支持配置多个 API Key 自动轮询使用
- 📊 任务管理：查看任务历史和状态，支持任务查询
快速开始
1. 获取 API Token
- 访问 https://modelscope.cn/my/myaccesstoken
- 登录后点击"创建新令牌"
- 重要：绑定阿里云账号（必须）
- 复制生成的 Token (格式:
ms-xxxxx)
2. 配置插件
在 Koishi 插件配置中添加 API Token，其他配置保持默认即可。
3. 开始使用
发送 moda 查看帮助信息和可用模型。
使用方法
文生图
# 使用默认模型（通用）
moda.qwen 一只可爱的猫
# 使用冷淡风美人模型
moda.beauty 一个冷淡风美女
# 使用连裤袜特化模型
moda.pantyhose 穿着连裤袜的女孩
# 指定图片分辨率
moda.qwen -s 1664x1664 一只可爱的猫
moda.beauty -s 512x512 一个冷淡风美女图片编辑
# 自动识别原图分辨率（默认启用）
# 如果原图是 2048x1536，会自动等比缩放到 1664x1248（默认最大边界）
[引用图片] moda.edit 把头发变成蓝色
# 或者先发送图片，再使用命令
[发送图片]
moda.edit 添加一副眼镜
# 手动指定输出图片分辨率（覆盖自动识别）
[引用图片] moda.edit -s 1024x1024 把头发变成蓝色分辨率处理说明：
- 默认启用自动识别原图分辨率并等比缩放到最大边界
- 缩放示例（默认边界 1664x1664）：
- 小图 512x512 → 放大到 1664x1664
- 大图 2048x1536 → 缩小到 1664x1248
- 竖图 1536x2048 → 缩小到 1248x1664
- 可在配置中切换为"原始分辨率"模式，直接使用原图尺寸
任务管理
# 查看任务列表
moda.tasks
# 查询具体任务
moda.check 1配置说明
基础配置
- apiKeys：ModelScope API Token 列表（必填，支持多个）
图片生成配置
通过表格配置多个文生图模型：
| 模型名称 | 别名 | 描述 | 注册指令 | 默认分辨率 |
|---|---|---|---|---|
| Qwen/Qwen-Image | qwen | 通用文生图模型 | ✓ | - |
| merjic/majicbeauty-qwen1 | beauty | 冷淡风美人 | ✓ | - |
| animationtj/Qwen_image_nude_pantyhose_lora | pantyhose | 肉色连裤袜特化 | ✓ | - |
- 列表第一个为默认模型（标记 *）
- 别名：用于快捷指令（如
moda.qwen） - 描述：在帮助信息中显示
- 注册指令：是否创建快捷指令
- 默认分辨率：该模型的默认图片分辨率（可选，如：1024x1024）
分辨率配置
- defaultSize：全局默认图片分辨率（默认：1024x1024）
- 格式：宽x高（如：1024x1024）
- 分辨率范围：
- SD系列：[64x64, 2048x2048]
- FLUX：[64x64, 1024x1024]
- Qwen-Image：[64x64, 1664x1664]
- 可在命令中使用
-s参数覆盖
图片编辑配置
通过表格配置图片编辑模型：
| 模型名称 | 别名 | 描述 | 注册指令 | 默认分辨率 |
|---|---|---|---|---|
| Qwen/Qwen-Image-Edit | edit | 通用图片编辑模型 | ✓ | - |
- editMaxRetries：编辑最大重试次数（默认：120，图片编辑很慢）
- editRetryInterval：编辑查询间隔（默认：10000 毫秒）
- autoDetectSize：自动识别原图分辨率（默认：true）
- 启用后，图片编辑时会自动读取原图分辨率
- 优先级：手动指定
-s参数 > 模型默认分辨率 > 自动识别分辨率 - 支持格式：PNG、JPEG、GIF、WebP
- scaleMode：分辨率处理模式（默认：等比缩放）
- 原始分辨率：直接使用原图尺寸，不做任何处理
- 等比缩放：将原图等比缩放到最大边界内（可能放大或缩小）
- 小图会放大到接近边界
- 大图会缩小到边界内
- 始终保持原图比例，不会变形
- maxWidth：最大宽度（默认：1664，范围：64-2048）
- 当缩放模式为"等比缩放"时生效
- maxHeight：最大高度（默认：1664，范围：64-2048）
- 当缩放模式为"等比缩放"时生效
性能配置
- generateMaxRetries：生成最大重试次数（默认：60）
- generateRetryInterval：生成查询间隔（默认：5000 毫秒）
调试选项
- enableLogs：启用控制台日志（默认：true）
内置模型
文生图模型
Qwen/Qwen-Image (qwen)
- 通用文生图模型
- 适合各种场景
- 响应速度快
merjic/majicbeauty-qwen1 (beauty)
- 冷淡风美人模型
- 专注人物生成
- 风格独特
animationtj/Qwen_image_nude_pantyhose_lora (pantyhose)
- 肉色连裤袜特化
- 细节处理优秀
图片编辑模型
- Qwen/Qwen-Image-Edit (edit)
- 通用图片编辑模型
- 支持语义编辑、外观修改、文字处理
自定义模型
可以在配置界面的表格中添加任何 ModelScope 上的图片生成模型：
- 在表格中添加新行
- 填写模型名称（如
username/model-name） - 设置别名（用于快捷指令）
- 添加描述（可选）
- 勾选是否注册指令
注意事项
- ⏱️ 图片生成：通常需要 10-30 秒
- ⏳ 图片编辑：通常需要 10 分钟以上，请耐心等待
- 🔑 API Key：必须绑定阿里云账号才能使用
- 📊 多 Key：配置多个 API Key 可提高调用成功率
- 🔄 任务管理：可使用
moda.tasks查看任务进度
示例
文生图：
moda.qwen 一只在草地上玩耍的可爱猫咪
moda.beauty 冷淡风格的美女肖像
moda.pantyhose 穿着连裤袜的动漫女孩
# 使用自定义分辨率
moda.qwen -s 1664x1664 高清猫咪图片
moda.beauty -s 512x768 竖版美女肖像图片编辑：
# 自动识别原图分辨率（默认启用）
[引用图片] moda.edit 把头发颜色变成蓝色
[引用图片] moda.edit 将背景改成星空
[引用图片] moda.edit 给猫咪添加一副眼镜
# 手动指定输出分辨率
[引用图片] moda.edit -s 1024x1024 把头发颜色变成蓝色
[引用图片] moda.edit -s 512x768 生成竖版图片License
MIT