🎨 minimax-image-gen
neuroXY 专属 AI 画图技能 | 基于 MiniMax Image API
📌 什么时候用
✅ 使用这个 skill：
- "画一张图片"
- "生成一张可爱猫咪的照片"
- "用动漫风格画少女"
- "创建一个赛博朋克风格的城市图"
❌ 不要用这个 skill：
- 视频生成 → 找其他工具
- 动画制作 → 找其他工具
🚀 快速开始
# 基本用法
python {baseDir}/scripts/gen.py -p "可爱的猫"
# 使用风格预设
python {baseDir}/scripts/gen.py -s "小猫" --preset 萌宠
# 生成并预览
python {baseDir}/scripts/gen.py -p "风景" --preview
⚙️ 配置
API Key 配置
方式一：环境变量（推荐）
# Windows
$env:MINIMAX_API_KEY = "your-api-key"
# Mac/Linux
export MINIMAX_API_KEY="your-api-key"
方式二：OpenClaw 配置
{
"skills": {
"entries": {
"minimax-image-gen": {
"enabled": true,
"env": {
"MINIMAX_API_KEY": "your-key"
}
}
}
}
}
方式三：自动加载
本技能会自动从 ~/.openclaw/openclaw.json 读取已配置的 Minimax API Key。
获取 API Key
访问：https://platform.minimaxi.com/user-center/interface-key
📖 使用指南
命令行参数
| 参数 | 简写 | 说明 | 默认值 |
|---|
--prompt | -p | 图片描述（必填） | - |
--subject | -s | 主体描述（用于预设） | - |
--count | -c | 生成数量 (1-9) | 1 |
--aspect-ratio | -a | 宽高比 | 1:1 |
--model | -m | 模型 | image-01 |
--preset | - | 风格预设 | - |
--style | - | 风格类型 | - |
--out-dir | -o | 输出目录 | ./output |
--preview | - | 生成后预览 | false |
--list-presets | - | 列出所有预设 | - |
宽高比选项
| 值 | 尺寸 | 适用场景 |
|---|
1:1 | 1024×1024 | 头像、方形图 |
16:9 | 1280×720 | 壁纸、横幅 |
4:3 | 1152×864 | 照片 |
3:2 | 1248×832 | 摄影 |
2:3 | 832×1248 | 竖版人物 |
3:4 | 864×1152 | 竖版肖像 |
9:16 | 720×1280 | 手机壁纸 |
21:9 | 1344×576 | 超宽屏 |
模型说明
| 模型 | 说明 |
|---|
image-01 | 默认模型，高质量，支持所有宽高比 |
image-01-live | 动漫/生活风格，支持风格参数 |
🎭 风格预设
本技能内置 13 种 精心调优的风格预设：
动漫/二次元
| 预设 | 说明 | 推荐宽高比 |
|---|
动漫少女 | 动漫少女风格，大眼睛，精致五官 | 3:4 |
漫画风 | 漫画风格，简洁线条 | 1:1 |
艺术风格
| 预设 | 说明 | 推荐宽高比 |
|---|
水彩画 | 水彩艺术风格，梦幻氛围 | 16:9 |
浮世绘 | 日本传统浮世绘风格 | 16:9 |
像素艺术 | 8-bit 复古游戏风格 | 1:1 |
人物/肖像
| 预设 | 说明 | 推荐宽高比 |
|---|
证件照 | 专业证件照，白底 | 3:4 |
肖像 | 专业人像摄影，影棚灯光 | 3:2 |
创意/科幻
| 预设 | 说明 | 推荐宽高比 |
|---|
赛博朋克 | 霓虹灯光，未来科技感 | 16:9 |
风景/建筑
| 预设 | 说明 | 推荐宽高比 |
|---|
风景画 | 油画风格风景 | 16:9 |
建筑摄影 | 现代建筑摄影 | 3:2 |
动物/宠物
产品/美食
| 预设 | 说明 | 推荐宽高比 |
|---|
美食摄影 | 餐厅风格美食 | 1:1 |
产品图 | 商业产品摄影 | 1:1 |
使用预设
# 使用预设 + 主体
python gen.py -s "穿校服的少女" --preset 动漫少女
# 纯手动
python gen.py -p "赛博朋克城市" --preset 赛博朋克
仅 image-01-live 可用风格
| 风格值 | 说明 |
|---|
漫画 | 漫画风格 |
元气 | 元气满满 |
中世纪 | 中世纪风格 |
水彩 | 水彩画风 |
💻 示例
示例 1：生成萌宠图片
python gen.py -s "英国短毛猫" --preset 萌宠 --preview
示例 2：创建风景壁纸
python gen.py -p "日落时的海滩" -a 16:9 -c 3 --preview
示例 3：动漫少女
python gen.py -s "粉色头发的女孩" --preset 动漫少女 --style 元气 --preview
示例 4：赛博朋克城市
python gen.py -p "未来的东京街头" --preset 赛博朋克 -c 4 --preview
示例 5：列出所有预设
python gen.py --list-presets
🔧 高级用法
自定义输出目录
python gen.py -p "图片" -o "E:/my-images"
禁用 Prompt 优化
python gen.py -p "具体描述" --no-optimizer
保存到指定位置并预览
python gen.py -p "猫" -o "C:/Users/asus/Pictures" --preview
📁 输出
- 目录:
./output (默认)
- 格式: PNG
- 命名:
minimax-{时间戳}-{描述}-{序号}.png
⚠️ 错误处理
| 错误码 | 说明 | 解决方案 |
|---|
| 1002 | 限流 | 稍后重试 |
| 1004 | API Key 错误 | 检查 Key 是否正确 |
| 1008 | 余额不足 | 充值 |
| 1026 | 内容敏感 | 修改 prompt |
| 2013 | 参数错误 | 检查参数 |
| 2049 | 无效 API Key | 重新获取 Key |
🔐 安全特性
- ✅ 输入验证和清理
- ✅ API Key 不写入日志
- ✅ 敏感信息错误提示
- ✅ SSL/TLS 加密传输
- ✅ 超时保护
🌍 跨平台支持
| 平台 | 预览方式 |
|---|
| Windows | 默认图片查看器 |
| macOS | Preview / Finder |
| Linux | xdg-open |
📝 更新日志
v1.1.0 (2026-03-18)
- 🎉 添加 13 种风格预设
- ✨ 支持风格类型 (漫画/元气/中世纪/水彩)
- 🔧 优化跨平台兼容性
- 🛡️ 增强安全性
- 📖 完善文档
v1.0.0 (2026-03-17)
📄 License
MIT License - Created by neuroXY
有问题随时问 neuroXY！🦐