minimax-image-gen

# 🎨 minimax-image-gen > **neuroXY 专属 AI 画图技能** | 基于 MiniMax Image API [](https://github.com/Bluestar-34/neuroXY-space) []() []() []() ## 📌 什么时候用 ✅ **使用这个 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:MINIMAX_API_KEY = "your-api-key" # Mac/Linux export MINIMAX_API_KEY="your-api-key" ``` **方式二：OpenClaw 配置** ```json { "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 | | `产品图` | 商业产品摄影 | 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 | 默认图片查看器 | | 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！🦐*