🎨 minimax-image-gen

neuroXY 专属 AI 画图技能 | 基于 MiniMax Image API

[]()
[]()
[]()

📌 什么时候用

✅ 使用这个 skill：

• - 画一张图片
• 生成一张可爱猫咪的照片
• 用动漫风格画少女
• 创建一个赛博朋克风格的城市图

❌ 不要用这个 skill：

• - 视频生成 → 找其他工具
• 动画制作 → 找其他工具

🚀 快速开始

bash

基本用法

python {baseDir}/scripts/gen.py -p 可爱的猫

使用风格预设

python {baseDir}/scripts/gen.py -s 小猫 --preset 萌宠

生成并预览

python {baseDir}/scripts/gen.py -p 风景 --preview

⚙️ 配置

API Key 配置

方式一：环境变量（推荐）
powershell

Windows

$env:MINIMAXAPIKEY = your-api-key

Mac/Linux

export MINIMAXAPIKEY=your-api-key

方式二：OpenClaw 配置
json
{
skills: {
entries: {
minimax-image-gen: {
enabled: true,
env: {
MINIMAXAPIKEY: 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
产品图

商业产品摄影 | 1:1 |

使用预设

bash

使用预设 + 主体

python gen.py -s 穿校服的少女 --preset 动漫少女

纯手动

python gen.py -p 赛博朋克城市 --preset 赛博朋克

仅 image-01-live 可用风格

风格值	说明
漫画	漫画风格
元气

元气满满 | | 中世纪 | 中世纪风格 | | 水彩 | 水彩画风 |

💻 示例

示例 1：生成萌宠图片

bash python gen.py -s 英国短毛猫 --preset 萌宠 --preview

示例 2：创建风景壁纸

bash python gen.py -p 日落时的海滩 -a 16:9 -c 3 --preview

示例 3：动漫少女

bash python gen.py -s 粉色头发的女孩 --preset 动漫少女 --style 元气 --preview

示例 4：赛博朋克城市

bash python gen.py -p 未来的东京街头 --preset 赛博朋克 -c 4 --preview

示例 5：列出所有预设

bash python gen.py --list-presets

🔧 高级用法

自定义输出目录

bash python gen.py -p 图片 -o E:/my-images

禁用 Prompt 优化

bash python gen.py -p 具体描述 --no-optimizer

保存到指定位置并预览

bash 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

默认图片查看